deep-code-agent: Instructions file for Claude Code

CLAUDE.md - Deep Code Agent

Quick Reference

• Package Name: deep_code_agent
• Entry Point: uv run deep-code-agent
• Python Version: 3.10+
• Package Manager: uv

Common Commands

# Install dependencies
uv sync

# Run the CLI
uv run deep-code-agent

# Run with specific options
uv run deep-code-agent --backend-type filesystem --model-name gpt-4

# Run with TUI mode
uv run deep-code-agent --tui

# Run tests
uv run pytest tests/

# Build package
uv build

# Install in editable mode
uv pip install -e .

Project Structure

src/deep_code_agent/
├── __init__.py          # Package exports
├── __main__.py          # Module entry point
├── cli.py               # CLI implementation
├── config.py            # Configuration constants
├── prompts.py           # System prompts and subagents
├── code_agent.py        # Main agent creation
├── models/llms/         # LLM integrations
├── tools/               # Agent tools
└── tui/                 # Terminal User Interface
    ├── app.py            # Main TUI application
    ├── bridge/            # Agent-bridge layer
    │   ├── agent_bridge.py
    │   └── stream_handler.py
    ├── screens/           # TUI screens
    │   ├── main_screen.py
    │   └── approval_modal.py
    ├── widgets/           # Reusable widgets
    │   ├── chat_log.py
    │   ├── input_box.py
    │   ├── message_bubble.py
    │   ├── side_panel.py
    │   ├── status_bar.py
    │   └── tool_call_view.py
    └── styles/            # TUI styles
        └── main.tcss

Key Patterns

1. Creating a Code Agent

from deep_code_agent import create_code_agent

# State backend (default)
agent = create_code_agent(
    codebase_dir="/path/to/code",
    backend_type="state"
)

# Filesystem backend (with terminal tool)
agent = create_code_agent(
    codebase_dir="/path/to/code",
    backend_type="filesystem"
)

2. Configuration Constants

All configuration is centralized in config.py:

from deep_code_agent.config import (
    MAX_TIMEOUT,          # 300 seconds
    DEFAULT_TIMEOUT,      # 30 seconds
    DEFAULT_INTERRUPT_ON # HITL defaults
)