Agent skill
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 this agent skill to your Project
npx add-skill https://github.com/base44/skills/tree/main/skills/base44-troubleshooter
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
sync-cli-skill
Synchronize the base44-cli skill with the latest CLI source code from the Base44 CLI repository
sync-sdk-skill
Synchronize the base44-sdk skill with the latest SDK source code from the Base44 SDK repository
review-skills
Review and analyze a skill against best practices for length, intent scope, and trigger patterns
skill-creator
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
base44-sdk
The base44 SDK is the library to communicate with base44 services. In projects, you use it to communicate with remote resources (entities, backend functions, ai agents) and to write backend functions. This skill is the place for learning about available modules and types. When you plan or implement a feature, you must learn this skill
base44-cli
The base44 CLI is used for EVERYTHING related to base44 projects: resource configuration (entities, backend functions, ai agents), initialization and actions (resource creation, deployment). This skill is the place for learning about how to configure resources. When you plan or implement a feature, you must learn this skill
Didn't find tool you were looking for?