base44-troubleshooter
Troubleshoot production issues using backend function logs. Use when investigating app errors, debugging function calls, or diagnosing production problems in Base44 apps.
Install
Use with your agent
Install the base44-troubleshooter skill, then use it as build context. Run: npx skills add https://github.com/base44/skills --skill base44-troubleshooter. Then read the installed skill.md and follow its guidance to build or refactor my project.
Troubleshoot Production Issues
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
Available Commands
| Command | Description | Reference |
|---|---|---|
base44 logs | Fetch function logs for this app | project-logs.md |
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
--limitto fetch more entries if the default 50 isn't enough