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".

⭐17stars🔀1forks📁View on GitHub🕐Updated Jan 4, 2026⬇️1downloads

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.
namezed-logs
descriptionCheck 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 handling
  • error(...) - Error from agent
  • info(banjo) - Banjo startup
  • debug(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