How ycbro/deepseek-tui-bantch works
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: engine.rs Async engine · shell.rs Shell execution · app.rs Terminal UI · client.rs Streaming client
Components 22
Terminal interaction
- Terminal UI
crates/tui/src/tui/app.rs - CLI dispatcher
crates/cli/src/main.rs
Agent runtime
- Async engine
crates/tui/src/core/engine.rs - Streaming client
crates/tui/src/client.rs
Tools and workspace
- Tool registry
crates/tui/src/tools/spec.rs - Shell execution
crates/tui/src/tools/shell.rs - Workspace files
- Command sandbox
crates/tui/src/sandbox/mod.rs - Execution policy
crates/tui/src/execpolicy/mod.rs - LSP diagnostics
crates/tui/src/lsp/mod.rs
Context and persistence
- Session save/resume
crates/tui/src/session_manager.rs - Durable task queue
crates/tui/src/task_manager.rs - Context compaction
crates/tui/src/compaction.rs - Cycle handoff
crates/tui/src/cycle_manager.rs - User memory
crates/tui/src/memory.rs
External integrations
- Model API
- MCP servers
crates/tui/src/mcp.rs - RLM analysis
crates/tui/src/rlm/turn.rs - Installable skills
crates/tui/src/skills/install.rs - HTTP/SSE runtime
crates/app-server/src/lib.rs
Other components
- Terminal user
- Headless caller
Connections 21
- Terminal user → Terminal UI: enters request
README.md - Terminal UI → Async engine: sends input
README.md - Async engine → Streaming client: requests completion
README.md - Streaming client → Model API: streams requests
README.md - Async engine → Tool registry: dispatches tools
README.md - Tool registry → Shell execution: routes calls
crates/tui/src/tools/spec.rs - Shell execution → Workspace files: reads or changes
- Shell execution → Command sandbox: uses sandbox
crates/tui/src/tools/shell.rs - Shell execution → Execution policy: checks policy
crates/tui/src/tools/shell.rs - Async engine → LSP diagnostics: feeds diagnostics
README.md - Async engine → Context compaction: compacts context
crates/tui/src/core/engine.rs - Async engine → Cycle handoff: manages cycles
crates/tui/src/core/engine.rs - Terminal UI → Session save/resume: saves sessions
README.md - Async engine → Durable task queue: manages tasks
README.md - Async engine → User memory: injects notes
README.md - Async engine → MCP servers: routes MCP tools
README.md - Async engine → RLM analysis: runs analysis
README.md - Async engine → Installable skills: uses instructions
- Headless caller → HTTP/SSE runtime: submits workflow
README.md - HTTP/SSE runtime → Async engine: serves agent
- CLI dispatcher → Terminal UI: launches runtime
README.md