debug-toolbar: Command for Claude Code

Codebase Exploration

You are exploring: $ARGUMENTS

Exploration Strategy

Use the Task tool with subagent_type=Explore for thorough codebase exploration.

Quick Reference

Architecture Overview

src/debug_toolbar/
├── __init__.py              # Public API exports
├── core/                    # Framework-agnostic core
│   ├── panel.py             # Panel ABC
│   ├── toolbar.py           # DebugToolbar manager
│   ├── config.py            # DebugToolbarConfig
│   ├── context.py           # RequestContext
│   ├── storage.py           # ToolbarStorage
│   └── panels/              # Built-in panels
├── litestar/                # Litestar integration
│   ├── plugin.py            # DebugToolbarPlugin
│   ├── middleware.py        # ASGI middleware
│   ├── config.py            # LitestarDebugToolbarConfig
│   ├── routes/              # API routes
│   └── panels/              # Litestar-specific panels
└── extras/                  # Optional integrations
    └── advanced_alchemy/    # SQLAlchemy/AA integration

Key Classes

Class	Location	Purpose
Panel	core/panel.py	Abstract base for all panels
DebugToolbar	core/toolbar.py	Main toolbar manager
DebugToolbarConfig	core/config.py	Core configuration
RequestContext	core/context.py	Request-scoped data
DebugToolbarPlugin	litestar/plugin.py	Litestar integration

Common Exploration Tasks

Find all panels:

grep -r "class.*Panel" src/debug_toolbar/

Find all configs:

grep -r "class.*Config" src/debug_toolbar/

Find all tests for a module:

find tests/ -name "test_*.py" | xargs grep -l "{module_name}"

Find usage of a class:

grep -r "ClassName" src/ tests/

Deep Exploration

For complex exploration, use:

Task(
    subagent_type="Explore",
    prompt="Explore {topic} in the codebase. Find:
    1. All related files
    2. Key patterns used
    3. How components connect
    4. Testing approaches"
)