zed-logs
Check Zed editor logs for banjo/agent errors. Use when user says "check zed logs", "zed errors", or "what's the zed error".
When & Why to Use This Skill
This Claude skill provides specialized log analysis and troubleshooting capabilities for the Zed editor's agent system. It streamlines the process of identifying, monitoring, and resolving banjo/agent errors and ACP connection issues, helping developers maintain a stable and efficient coding environment through automated log inspection.
Use Cases
- Diagnosing Agent Failures: Quickly identify the root cause of agent crashes or startup issues by filtering Zed logs for 'banjo' or 'agent' specific errors.
- Real-time Debugging: Monitor live log streams to observe how the agent handles requests and identify intermittent connection or registration issues as they happen.
- Configuration Troubleshooting: Resolve 'UnknownField' or 'not registered' errors by verifying agent server keys and parameter structures within the Zed settings.
- Log Maintenance: Efficiently clear and reset log files to isolate new errors during active development and testing of agent integrations.
| name | zed-logs |
|---|---|
| description | Check Zed editor logs for banjo/agent errors. Use when user says "check zed logs", "zed errors", or "what's the zed error". |
Zed Logs
Check Zed editor logs for ACP agent issues.
Commands
# Recent agent logs (banjo + errors)
tail -100 ~/Library/Logs/Zed/Zed.log | grep -i -E "(banjo|agent|error)" | tail -30
# All recent logs
tail -50 ~/Library/Logs/Zed/Zed.log
# Follow logs live
tail -f ~/Library/Logs/Zed/Zed.log | grep -i agent
# Clear and watch
: > ~/Library/Logs/Zed/Zed.log && tail -f ~/Library/Logs/Zed/Zed.log
Log Patterns
agent stderr:- Output from agent process (banjo logs here)agent_servers::acp- ACP connection handlingerror(...)- Error from agentinfo(banjo)- Banjo startupdebug(agent)- Request handling
Common Issues
| Error | Cause | Fix |
|---|---|---|
UnknownField |
Missing field in param struct | Add field or ignore_unknown_fields = true |
not registered |
Config key mismatch | Check agent_servers key in Zed settings |
| No output | Agent crashed on startup | Run ./zig-out/bin/banjo manually to see error |
Zed Config Location
~/.config/zed/settings.json → agent_servers