How hksae/sqwai works
sqwai is a terminal coding agent whose host-owned task loop sends model requests, executes tools, and presents results in the TUI. Plans gate completion on recorded evidence; the journal supports history and recovery, while context compaction preserves task state. The README also identifies project knowledge-graph indexing and durable diary/memory as product capabilities. Edges follow explicit README statements or SOURCE INDEX references; many internal details are unsampled, so those relationships are omitted rather than inferred.
Main entry points: loop_task/mod.rs Agent loop · app/mod.rs Terminal UI · tools/mod.rs Tool registry · prompts/mod.rs Prompt assembly
Components 24
Terminal interface
- Application entry
src/main.rs - Terminal UI
src/tui/app/mod.rs - UI rendering
src/tui/app/view.rs - UI menus
src/tui/app/menus.rs
Agent runtime
- Agent loop
src/agent/loop_task/mod.rs - Tool registry
src/agent/tools/mod.rs - Command execution
src/agent/tools/exec.rs - Context compaction
src/agent/context.rs
Task governance
- Plan operations
src/plan/mod.rs
Durable state
- Plan persistence
src/plan/store.rs - Event journal
src/agent/journal.rs - Checkpoints
src/agent/checkpoints.rs - Session history
src/session/mod.rs - Diary
src/agent/diary.rs - Durable memory
src/agent/memory.rs - Knowledge graph store
src/agent/graph.rs
Model and project context
- Model providers
src/providers/mod.rs - Configuration
src/config/mod.rs - Prompt assembly
src/prompts/mod.rs - Project graph indexing
src/agent/graph_index.rs - Graph language analysis
src/agent/graph_lang.rs
Other components
- User
- Project files
- Model service
Connections 28
- User → Terminal UI: interacts
README.md - Application entry → Terminal UI: starts
src/main.rs - Terminal UI → Agent loop: runs
src/tui/app/mod.rs - Terminal UI → UI rendering: renders
src/tui/app/mod.rs - Terminal UI → UI menus: opens
src/tui/app/mod.rs - Agent loop → Model providers: requests
src/agent/loop_task/mod.rs - Model providers → Model service: calls
README.md - Agent loop → Tool registry: dispatches
src/agent/loop_task/mod.rs - Tool registry → Command execution: delegates
src/agent/tools/mod.rs - Agent loop → Context compaction: compacts
src/agent/loop_task/mod.rs - Agent loop → Plan operations: uses
src/agent/loop_task/mod.rs - Tool registry → Plan operations: operates
src/agent/tools/mod.rs - Plan operations → Plan persistence: persists
src/plan/mod.rs - Plan persistence → Event journal: replays
src/plan/store.rs - Agent loop → Event journal: records
src/agent/loop_task/mod.rs - Agent loop → Checkpoints: manages
src/agent/loop_task/mod.rs - Terminal UI → Session history: manages
src/tui/app/mod.rs - Agent loop → Diary: uses
src/agent/loop_task/mod.rs - Prompt assembly → Diary: includes
src/prompts/mod.rs - Prompt assembly → Plan operations: renders
src/prompts/mod.rs - Terminal UI → Prompt assembly: assembles
src/tui/app/mod.rs - Prompt assembly → Configuration: reads
src/prompts/mod.rs - Model providers → Configuration: resolves
src/providers/mod.rs - Project graph indexing → Knowledge graph store: indexes
src/agent/graph_index.rs - Project graph indexing → Graph language analysis: uses
src/agent/graph_index.rs - Project files → Project graph indexing: supplies files
- Tool registry → Project files: edits
- Agent loop → Durable memory: uses
src/agent/loop_task/mod.rs