Deep-Coder

# Deep Coder

Deep Coder is a project-scoped terminal coding agent built around the DeepSeek API. It launches as a Textual TUI, keeps session history isolated per workspace, streams tool activity into a replayable timeline, and persists runtime state under `~/.deepcode/`.

The current product is the package-based runtime under `deep_coder/` plus the `deepcode` launcher. `agentLoop.py` remains in the repository as a legacy prototype and reference file, not the main entrypoint.

## Highlights

- Project-scoped sessions: each workspace resolves to a stable project record and its own persisted state root.
- Terminal-first workflow: one timeline, one composer, live event streaming, and replay of stored sessions.
- Local coding tools: bash, file read/write/edit, session task tools, and layered history search/load tools.
- Layered context: recent turns, persisted evidence, and summaries are assembled through the context layer instead of a flat transcript replay.
- DeepSeek-backed runtime: the model adapter uses the OpenAI-compatible Python SDK with DeepSeek as the current provider.

## Installation

### Install From Source As A Command

Clone the repository and install it into your user site-packages so `deepcode` is available on your shell `PATH`:

```bash
git clone <repository-url>
cd Deep-Coder
python3 -m pip install --user .
```

On many Linux systems this installs the command into `~/.local/bin`. If `deepcode` is not found after installation, add that directory to your `PATH`.

### Editable Install For Contributors

If you want an editable checkout for development:

```bash
git clone <repository-url>
cd Deep-Coder
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -e ".[dev]"
```

That exposes `deepcode` inside the virtual environment and installs `pytest` for local verification.

### Required Environment

Deep Coder currently requires a Claude API key:

```bash
export DEEPSEEK_API_KEY="your-api-key"
```

### Launcher Fallback

For repository-local de