Deebo: AI Agent's Debugging Partner
What is Deebo: AI Agent’s Debugging Partner
Deebo is an agentic debugging copilot designed to enhance the debugging process for AI coding agents by introducing parallel processing into the workflow. It significantly accelerates the time-to-resolution for software errors, aiming for a tenfold improvement compared to traditional debugging methods.
Use cases
Deebo is ideal for teams and developers who utilize AI agents for coding in production environments. It is particularly useful for debugging complex software errors, automating investigations, and improving overall productivity by leveraging AI capabilities to handle coding challenges more efficiently.
How to use
To use Deebo, first install it with the command ‘npx deebo-setup@latest’. After installation, configure the required settings in a specified configuration file. When encountering a bug, instruct your AI agent to delegate the debugging task to Deebo, providing necessary context like error messages and repository paths. Monitor the investigation’s progress and optionally influence its direction with new observations.
Key features
Key features of Deebo include automated error investigations, real-time session management, the ability to add observational inputs to refine the debugging process, and compatibility with various OpenAI-compatible SDKs. It also creates a memory bank to track debugging sessions and logs for future reference.
Where to use
Deebo is designed for software development environments where AI coding agents are utilized, including projects that demand robust debugging capabilities. It works seamlessly with different programming languages and platforms, making it suitable for teams using AI to enhance coding practices.
Overview
What is Deebo: AI Agent’s Debugging Partner
Deebo is an agentic debugging copilot designed to enhance the debugging process for AI coding agents by introducing parallel processing into the workflow. It significantly accelerates the time-to-resolution for software errors, aiming for a tenfold improvement compared to traditional debugging methods.
Use cases
Deebo is ideal for teams and developers who utilize AI agents for coding in production environments. It is particularly useful for debugging complex software errors, automating investigations, and improving overall productivity by leveraging AI capabilities to handle coding challenges more efficiently.
How to use
To use Deebo, first install it with the command ‘npx deebo-setup@latest’. After installation, configure the required settings in a specified configuration file. When encountering a bug, instruct your AI agent to delegate the debugging task to Deebo, providing necessary context like error messages and repository paths. Monitor the investigation’s progress and optionally influence its direction with new observations.
Key features
Key features of Deebo include automated error investigations, real-time session management, the ability to add observational inputs to refine the debugging process, and compatibility with various OpenAI-compatible SDKs. It also creates a memory bank to track debugging sessions and logs for future reference.
Where to use
Deebo is designed for software development environments where AI coding agents are utilized, including projects that demand robust debugging capabilities. It works seamlessly with different programming languages and platforms, making it suitable for teams using AI to enhance coding practices.
Content
Deebo: Your AI Agent’s Debugging Copilot
Deebo is an agentic debugging copilot for your AI coding agent that speeds up time-to-resolution by 10x. If your main coding agent is like a single-threaded process, Deebo introduces multi-threadedness to your development workflow.
feedback, questions/support? check out Deebo Guide below, or dm me on x @sriramenn
If you think your team can benefit from Deebo, we’d love to hear from you. We’re partnering with teams who use AI agents to write production code and want to maximize their productivity. Reach out for a live walkthrough, custom setup support, or to explore early access to enterprise features.
Quick Install
npx deebo-setup@latest
Manual Configuration
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 Guide
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!
Watch the full work session with Cline + Deebo here (3 mins, sped up)
License
Apache License 2.0 — see LICENSE for details.