base44-troubleshooter

✓ Official★ 4,081

by openai · part of openai/plugins

Troubleshoot production issues using backend function logs. Use when investigating app errors, debugging function calls, or diagnosing production problems in Base44 apps.

🧩 One of 7 skills in the openai/plugins package — works on its own, and pairs well with its siblings.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

Troubleshoot Production Issues

Available Commands

Command	Description	Reference
`base44 logs`	Fetch function logs for this app	project-logs.md

Copy & paste — that's it

npx skills add https://github.com/openai/plugins --skill base44-troubleshooter

Run this in your project — your agent picks the skill up automatically.

Prerequisites

Verify authentication before fetching logs:

npx base44 whoami

If not authenticated or token expired, instruct user to run npx base44 login.

Must be run from the project directory (where base44/.app.jsonc exists):

cat base44/.app.jsonc

Troubleshooting Flow

1. Check Recent Errors

Start by pulling the latest errors across all functions:

npx base44 logs --level error

2. Drill Into a Specific Function

If you know which function is failing:

npx base44 logs --function <function_name> --level error

3. Inspect a Time Range

Correlate with user-reported issue timestamps:

npx base44 logs --function <function_name> --since <start_time> --until <end_time>

4. Analyze the Logs

Look for stack traces and error messages in the output
Check timestamps to correlate with user-reported issues
Use --limit to fetch more entries if the default 50 isn't enough