# ycbro/deepseek-tui-bantch architecture

> Architecture diagram of the GitHub repository ycbro/deepseek-tui-bantch, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ycbro/deepseek-tui-bantch
- Repository: https://github.com/ycbro/deepseek-tui-bantch

## Overview

DeepSeek TUI is a terminal coding agent for DeepSeek V4. The main workflow begins with a user entering a request in the terminal UI; the asynchronous engine sends it to a streaming model client, dispatches model tool calls, and presents results in the transcript. Tools can inspect or modify the workspace, run commands under approval and sandbox policies, and use external services. The graph also preserves documented session, task, context, MCP, LSP, skills, memory, and headless API capabilities. Internal links are limited to documented wiring and SOURCE INDEX references; unsampled subsystems are represented at supported paths.

Main entry points: [`crates/tui/src/core/engine.rs`](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/core/engine.rs) (Async engine), [`crates/tui/src/tools/shell.rs`](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/tools/shell.rs) (Shell execution), [`crates/tui/src/tui/app.rs`](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/tui/app.rs) (Terminal UI), [`crates/tui/src/client.rs`](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/client.rs) (Streaming client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Terminal interaction"]
  node_tui["Terminal UI<br/>[app.rs]"]
  node_dispatcher["CLI dispatcher<br/>[main.rs]"]
end

subgraph group_reasoning["Agent runtime"]
  node_engine["Async engine<br/>[engine.rs]"]
  node_model_client["Streaming client<br/>[client.rs]"]
end

subgraph group_tools["Tools and workspace"]
  node_tool_suite["Tool registry<br/>[spec.rs]"]
  node_shell["Shell execution<br/>[shell.rs]"]
  node_workspace["Workspace files"]
  node_sandbox["Command sandbox<br/>[mod.rs]"]
  node_exec_policy["Execution policy<br/>[mod.rs]"]
  node_lsp["LSP diagnostics<br/>[mod.rs]"]
end

subgraph group_state["Context and persistence"]
  node_sessions[("Session save/resume<br/>[session_manager.rs]")]
  node_task_queue[("Durable task queue<br/>[task_manager.rs]")]
  node_context["Context compaction<br/>[compaction.rs]"]
  node_cycles["Cycle handoff<br/>[cycle_manager.rs]"]
  node_memory["User memory<br/>[memory.rs]"]
end

subgraph group_integrations["External integrations"]
  node_llm_api{{"Model API"}}
  node_mcp{{"MCP servers<br/>[mcp.rs]"}}
  node_rlm["RLM analysis<br/>[turn.rs]"]
  node_skills["Installable skills<br/>[install.rs]"]
  node_http_api["HTTP/SSE runtime<br/>[lib.rs]"]
end

node_user(("Terminal user"))
node_http_caller(("Headless caller"))

node_user -->|"enters request"| node_tui
node_tui -->|"sends input"| node_engine
node_engine -->|"requests completion"| node_model_client
node_model_client -->|"streams requests"| node_llm_api
node_engine -->|"dispatches tools"| node_tool_suite
node_tool_suite -.->|"routes calls"| node_shell
node_shell -.->|"reads or changes"| node_workspace
node_shell -->|"uses sandbox"| node_sandbox
node_shell -->|"checks policy"| node_exec_policy
node_engine -->|"feeds diagnostics"| node_lsp
node_engine -->|"compacts context"| node_context
node_engine -->|"manages cycles"| node_cycles
node_tui -->|"saves sessions"| node_sessions
node_engine -->|"manages tasks"| node_task_queue
node_engine -->|"injects notes"| node_memory
node_engine -->|"routes MCP tools"| node_mcp
node_engine -->|"runs analysis"| node_rlm
node_engine -.->|"uses instructions"| node_skills
node_http_caller -->|"submits workflow"| node_http_api
node_http_api -.->|"serves agent"| node_engine
node_dispatcher -->|"launches runtime"| node_tui

click node_tui "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/tui/app.rs"
click node_dispatcher "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/cli/src/main.rs"
click node_engine "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/core/engine.rs"
click node_model_client "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/client.rs"
click node_tool_suite "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/tools/spec.rs"
click node_shell "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/tools/shell.rs"
click node_sandbox "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/sandbox/mod.rs"
click node_exec_policy "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/execpolicy/mod.rs"
click node_lsp "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/lsp/mod.rs"
click node_sessions "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/session_manager.rs"
click node_task_queue "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/task_manager.rs"
click node_context "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/compaction.rs"
click node_cycles "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/cycle_manager.rs"
click node_memory "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/memory.rs"
click node_mcp "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/mcp.rs"
click node_rlm "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/rlm/turn.rs"
click node_skills "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/skills/install.rs"
click node_http_api "https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/app-server/src/lib.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_tui,node_dispatcher,node_user toneBlue
class node_engine,node_model_client toneAmber
class node_tool_suite,node_shell,node_workspace,node_sandbox,node_exec_policy,node_lsp toneMint
class node_sessions,node_task_queue,node_context,node_cycles,node_memory toneRose
class node_llm_api,node_mcp,node_rlm,node_skills,node_http_api,node_http_caller toneIndigo
```

## Components

### Terminal interaction

- [Terminal UI](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/tui/app.rs): `crates/tui/src/tui/app.rs`
- [CLI dispatcher](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/cli/src/main.rs): `crates/cli/src/main.rs`

### Agent runtime

- [Async engine](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/core/engine.rs): `crates/tui/src/core/engine.rs`
- [Streaming client](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/client.rs): `crates/tui/src/client.rs`

### Tools and workspace

- [Tool registry](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/tools/spec.rs): `crates/tui/src/tools/spec.rs`
- [Shell execution](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/tools/shell.rs): `crates/tui/src/tools/shell.rs`
- **Workspace files**
- [Command sandbox](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/sandbox/mod.rs): `crates/tui/src/sandbox/mod.rs`
- [Execution policy](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/execpolicy/mod.rs): `crates/tui/src/execpolicy/mod.rs`
- [LSP diagnostics](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/lsp/mod.rs): `crates/tui/src/lsp/mod.rs`

### Context and persistence

- [Session save/resume](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/session_manager.rs): `crates/tui/src/session_manager.rs`
- [Durable task queue](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/task_manager.rs): `crates/tui/src/task_manager.rs`
- [Context compaction](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/compaction.rs): `crates/tui/src/compaction.rs`
- [Cycle handoff](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/cycle_manager.rs): `crates/tui/src/cycle_manager.rs`
- [User memory](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/memory.rs): `crates/tui/src/memory.rs`

### External integrations

- **Model API**
- [MCP servers](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/mcp.rs): `crates/tui/src/mcp.rs`
- [RLM analysis](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/rlm/turn.rs): `crates/tui/src/rlm/turn.rs`
- [Installable skills](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/tui/src/skills/install.rs): `crates/tui/src/skills/install.rs`
- [HTTP/SSE runtime](https://github.com/ycbro/deepseek-tui-bantch/blob/main/crates/app-server/src/lib.rs): `crates/app-server/src/lib.rs`

### Other components

- **Terminal user**
- **Headless caller**

## Connections

- Terminal user → Terminal UI: enters request (evidence: `README.md`)
- Terminal UI → Async engine: sends input (evidence: `README.md`)
- Async engine → Streaming client: requests completion (evidence: `README.md`)
- Streaming client → Model API: streams requests (evidence: `README.md`)
- Async engine → Tool registry: dispatches tools (evidence: `README.md`)
- Tool registry → Shell execution: routes calls (evidence: `crates/tui/src/tools/spec.rs`)
- Shell execution → Workspace files: reads or changes
- Shell execution → Command sandbox: uses sandbox (evidence: `crates/tui/src/tools/shell.rs`)
- Shell execution → Execution policy: checks policy (evidence: `crates/tui/src/tools/shell.rs`)
- Async engine → LSP diagnostics: feeds diagnostics (evidence: `README.md`)
- Async engine → Context compaction: compacts context (evidence: `crates/tui/src/core/engine.rs`)
- Async engine → Cycle handoff: manages cycles (evidence: `crates/tui/src/core/engine.rs`)
- Terminal UI → Session save/resume: saves sessions (evidence: `README.md`)
- Async engine → Durable task queue: manages tasks (evidence: `README.md`)
- Async engine → User memory: injects notes (evidence: `README.md`)
- Async engine → MCP servers: routes MCP tools (evidence: `README.md`)
- Async engine → RLM analysis: runs analysis (evidence: `README.md`)
- Async engine → Installable skills: uses instructions
- Headless caller → HTTP/SSE runtime: submits workflow (evidence: `README.md`)
- HTTP/SSE runtime → Async engine: serves agent
- CLI dispatcher → Terminal UI: launches runtime (evidence: `README.md`)
