mcpbeat

Base44 Troubleshooter

openai/base44-troubleshooter

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

900 tokens
context cost
the whole folder, loaded on every use
3
files
instructions only
0
copies elsewhere
how many repositories repackaged it
4915
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/openai/plugins --skill base44-troubleshooter

What comes with it

2 174 bytes besides the instruction
agents/openai.yaml
references/project-logs.md

The instruction itself

8 sections, as written by the author

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 --limit to fetch more entries if the default 50 isn't enough

How to use it

Copy the folder

Take openai/base44-troubleshooter from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference npx. Without those the skill loads but fails at the first command.