After installing with deebo-setup, create a configuration file at your coding agent's specified location with the following content. First, add the guide server (which provides help documentation even if the main installation fails):

{
  "servers": {
    "deebo-guide": {
      "command": "node",
      "args": [
        "--experimental-specifier-resolution=node",
        "--experimental-modules",
        "/Users/[your-name]/.deebo/guide-server.js"
      ],
      "env": {},
      "transportType": "stdio"
    },
    "deebo": {
      "command": "node",
      "args": [
        "--experimental-specifier-resolution=node",
        "--experimental-modules",
        "--max-old-space-size=4096",
        "/Users/[your-name]/.deebo/build/index.js"
      ],
      "env": {
        "NODE_ENV": "development",
        "USE_MEMORY_BANK": "true",
        "MOTHER_HOST": "openrouter",
        "MOTHER_MODEL": "anthropic/claude-3.5-sonnet",
        "SCENARIO_HOST": "openrouter",
        "SCENARIO_MODEL": "deepseek/deepseek-chat",
        "OPENROUTER_API_KEY": "your-openrouter-api-key"
      }
    }
  }
}

Deebo works with any OpenAI-compatible SDK, Anthropic, Gemini, and OpenRouter.

Deebo helps your AI agent debug real software errors by launching automated investigations. Here's how to use it effectively.

1. Start a Debugging Session

When you hit a tough bug, ask your agent to delegate the task to Deebo.

What to include in your request:

• 🔧 The error (message, stack trace, or behavior)
• 📁 The absolute path to your Git repository
• 💡 Any helpful context, such as:
  • What you’ve already tried
  • Relevant files or code snippets
  • How to reproduce the issue
  • The language or environment

Example instruction to your agent:

“This error is happening in /path/to/repo, possibly related to auth logic. I already checked the session token parser. Can you delegate this to Deebo?”

Your agent will start a Deebo session and give you a session ID (e.g. session-1745...). Save it.

2. Check Investigation Progress

After ~30 seconds, ask your agent to check the status of the Deebo session using that session ID.

You’ll get a session pulse, which shows:

• Whether the investigation is in progress or completed
• What the system is currently exploring
• Summaries of findings, if any

3. Add Observations (Optional)

If you notice something important — or think Deebo is heading the wrong way — you can guide the investigation.

Ask your agent to pass a short observation to Deebo.

Example:

“Let Deebo know that the file size warnings might be a red herring — the issue is probably with the CI env vars.”

This may shift the direction of the investigation.

4. Cancel a Session (Optional)

If you fixed the issue or no longer need the investigation, tell your agent to cancel the Deebo session.

For AI Agents: Memory Bank Access

When asked to check debug session progress, look in: ~/.deebo/memory-bank/[project-hash]/sessions/[session-id]/logs/

The project hash is a unique identifier for each repository, and session IDs are provided when starting a debug session.

Want More?

We're piloting enterprise features that unlock unprecedented productivity gains for your team. Reach out if interested!