# hksae/sqwai architecture

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

- Interactive diagram: https://gitdiagram.com/hksae/sqwai
- Repository: https://github.com/hksae/sqwai

## Overview

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: [`src/agent/loop_task/mod.rs`](https://github.com/hksae/sqwai/blob/master/src/agent/loop_task/mod.rs) (Agent loop), [`src/tui/app/mod.rs`](https://github.com/hksae/sqwai/blob/master/src/tui/app/mod.rs) (Terminal UI), [`src/agent/tools/mod.rs`](https://github.com/hksae/sqwai/blob/master/src/agent/tools/mod.rs) (Tool registry), [`src/prompts/mod.rs`](https://github.com/hksae/sqwai/blob/master/src/prompts/mod.rs) (Prompt assembly)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Terminal interface"]
  node_main["Application entry<br/>[main.rs]"]
  node_tui["Terminal UI<br/>[mod.rs]"]
  node_views["UI rendering<br/>[view.rs]"]
  node_menus["UI menus<br/>[menus.rs]"]
end

subgraph group_agent["Agent runtime"]
  node_loop["Agent loop<br/>[mod.rs]"]
  node_tools["Tool registry<br/>[mod.rs]"]
  node_exec["Command execution<br/>[exec.rs]"]
  node_context["Context compaction<br/>[context.rs]"]
end

subgraph group_governance["Task governance"]
  node_plan["Plan operations<br/>[mod.rs]"]
end

subgraph group_state["Durable state"]
  node_planstore["Plan persistence<br/>[store.rs]"]
  node_journal[("Event journal<br/>[journal.rs]")]
  node_checkpoints["Checkpoints<br/>[checkpoints.rs]"]
  node_session["Session history<br/>[mod.rs]"]
  node_diary["Diary<br/>[diary.rs]"]
  node_memory["Durable memory<br/>[memory.rs]"]
  node_graph[("Knowledge graph store<br/>[graph.rs]")]
end

subgraph group_intelligence["Model and project context"]
  node_providers["Model providers<br/>[mod.rs]"]
  node_config["Configuration<br/>[mod.rs]"]
  node_prompts["Prompt assembly<br/>[mod.rs]"]
  node_graphindex["Project graph indexing<br/>[graph_index.rs]"]
  node_graphlang["Graph language analysis<br/>[graph_lang.rs]"]
end

node_user(("User"))
node_project["Project files"]
node_model["Model service"]

node_user -->|"interacts"| node_tui
node_main -->|"starts"| node_tui
node_tui -->|"runs"| node_loop
node_tui -->|"renders"| node_views
node_tui -->|"opens"| node_menus
node_loop -->|"requests"| node_providers
node_providers -->|"calls"| node_model
node_loop -->|"dispatches"| node_tools
node_tools -->|"delegates"| node_exec
node_loop -->|"compacts"| node_context
node_loop -->|"uses"| node_plan
node_tools -->|"operates"| node_plan
node_plan -->|"persists"| node_planstore
node_planstore -->|"replays"| node_journal
node_loop -->|"records"| node_journal
node_loop -->|"manages"| node_checkpoints
node_tui -->|"manages"| node_session
node_loop -->|"uses"| node_diary
node_prompts -->|"includes"| node_diary
node_prompts -->|"renders"| node_plan
node_tui -->|"assembles"| node_prompts
node_prompts -->|"reads"| node_config
node_providers -->|"resolves"| node_config
node_graphindex -->|"indexes"| node_graph
node_graphindex -->|"uses"| node_graphlang
node_project -.->|"supplies files"| node_graphindex
node_tools -.->|"edits"| node_project
node_loop -.->|"uses"| node_memory

click node_main "https://github.com/hksae/sqwai/blob/master/src/main.rs"
click node_tui "https://github.com/hksae/sqwai/blob/master/src/tui/app/mod.rs"
click node_views "https://github.com/hksae/sqwai/blob/master/src/tui/app/view.rs"
click node_menus "https://github.com/hksae/sqwai/blob/master/src/tui/app/menus.rs"
click node_loop "https://github.com/hksae/sqwai/blob/master/src/agent/loop_task/mod.rs"
click node_tools "https://github.com/hksae/sqwai/blob/master/src/agent/tools/mod.rs"
click node_exec "https://github.com/hksae/sqwai/blob/master/src/agent/tools/exec.rs"
click node_providers "https://github.com/hksae/sqwai/blob/master/src/providers/mod.rs"
click node_config "https://github.com/hksae/sqwai/blob/master/src/config/mod.rs"
click node_prompts "https://github.com/hksae/sqwai/blob/master/src/prompts/mod.rs"
click node_context "https://github.com/hksae/sqwai/blob/master/src/agent/context.rs"
click node_plan "https://github.com/hksae/sqwai/blob/master/src/plan/mod.rs"
click node_planstore "https://github.com/hksae/sqwai/blob/master/src/plan/store.rs"
click node_journal "https://github.com/hksae/sqwai/blob/master/src/agent/journal.rs"
click node_checkpoints "https://github.com/hksae/sqwai/blob/master/src/agent/checkpoints.rs"
click node_session "https://github.com/hksae/sqwai/blob/master/src/session/mod.rs"
click node_diary "https://github.com/hksae/sqwai/blob/master/src/agent/diary.rs"
click node_memory "https://github.com/hksae/sqwai/blob/master/src/agent/memory.rs"
click node_graphindex "https://github.com/hksae/sqwai/blob/master/src/agent/graph_index.rs"
click node_graph "https://github.com/hksae/sqwai/blob/master/src/agent/graph.rs"
click node_graphlang "https://github.com/hksae/sqwai/blob/master/src/agent/graph_lang.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_main,node_tui,node_views,node_menus,node_user toneBlue
class node_loop,node_tools,node_exec,node_context toneAmber
class node_plan toneMint
class node_planstore,node_journal,node_checkpoints,node_session,node_diary,node_memory,node_graph toneRose
class node_providers,node_config,node_prompts,node_graphindex,node_graphlang,node_project,node_model toneIndigo
```

## Components

### Terminal interface

- [Application entry](https://github.com/hksae/sqwai/blob/master/src/main.rs): `src/main.rs`
- [Terminal UI](https://github.com/hksae/sqwai/blob/master/src/tui/app/mod.rs): `src/tui/app/mod.rs`
- [UI rendering](https://github.com/hksae/sqwai/blob/master/src/tui/app/view.rs): `src/tui/app/view.rs`
- [UI menus](https://github.com/hksae/sqwai/blob/master/src/tui/app/menus.rs): `src/tui/app/menus.rs`

### Agent runtime

- [Agent loop](https://github.com/hksae/sqwai/blob/master/src/agent/loop_task/mod.rs): `src/agent/loop_task/mod.rs`
- [Tool registry](https://github.com/hksae/sqwai/blob/master/src/agent/tools/mod.rs): `src/agent/tools/mod.rs`
- [Command execution](https://github.com/hksae/sqwai/blob/master/src/agent/tools/exec.rs): `src/agent/tools/exec.rs`
- [Context compaction](https://github.com/hksae/sqwai/blob/master/src/agent/context.rs): `src/agent/context.rs`

### Task governance

- [Plan operations](https://github.com/hksae/sqwai/blob/master/src/plan/mod.rs): `src/plan/mod.rs`

### Durable state

- [Plan persistence](https://github.com/hksae/sqwai/blob/master/src/plan/store.rs): `src/plan/store.rs`
- [Event journal](https://github.com/hksae/sqwai/blob/master/src/agent/journal.rs): `src/agent/journal.rs`
- [Checkpoints](https://github.com/hksae/sqwai/blob/master/src/agent/checkpoints.rs): `src/agent/checkpoints.rs`
- [Session history](https://github.com/hksae/sqwai/blob/master/src/session/mod.rs): `src/session/mod.rs`
- [Diary](https://github.com/hksae/sqwai/blob/master/src/agent/diary.rs): `src/agent/diary.rs`
- [Durable memory](https://github.com/hksae/sqwai/blob/master/src/agent/memory.rs): `src/agent/memory.rs`
- [Knowledge graph store](https://github.com/hksae/sqwai/blob/master/src/agent/graph.rs): `src/agent/graph.rs`

### Model and project context

- [Model providers](https://github.com/hksae/sqwai/blob/master/src/providers/mod.rs): `src/providers/mod.rs`
- [Configuration](https://github.com/hksae/sqwai/blob/master/src/config/mod.rs): `src/config/mod.rs`
- [Prompt assembly](https://github.com/hksae/sqwai/blob/master/src/prompts/mod.rs): `src/prompts/mod.rs`
- [Project graph indexing](https://github.com/hksae/sqwai/blob/master/src/agent/graph_index.rs): `src/agent/graph_index.rs`
- [Graph language analysis](https://github.com/hksae/sqwai/blob/master/src/agent/graph_lang.rs): `src/agent/graph_lang.rs`

### Other components

- **User**
- **Project files**
- **Model service**

## Connections

- User → Terminal UI: interacts (evidence: `README.md`)
- Application entry → Terminal UI: starts (evidence: `src/main.rs`)
- Terminal UI → Agent loop: runs (evidence: `src/tui/app/mod.rs`)
- Terminal UI → UI rendering: renders (evidence: `src/tui/app/mod.rs`)
- Terminal UI → UI menus: opens (evidence: `src/tui/app/mod.rs`)
- Agent loop → Model providers: requests (evidence: `src/agent/loop_task/mod.rs`)
- Model providers → Model service: calls (evidence: `README.md`)
- Agent loop → Tool registry: dispatches (evidence: `src/agent/loop_task/mod.rs`)
- Tool registry → Command execution: delegates (evidence: `src/agent/tools/mod.rs`)
- Agent loop → Context compaction: compacts (evidence: `src/agent/loop_task/mod.rs`)
- Agent loop → Plan operations: uses (evidence: `src/agent/loop_task/mod.rs`)
- Tool registry → Plan operations: operates (evidence: `src/agent/tools/mod.rs`)
- Plan operations → Plan persistence: persists (evidence: `src/plan/mod.rs`)
- Plan persistence → Event journal: replays (evidence: `src/plan/store.rs`)
- Agent loop → Event journal: records (evidence: `src/agent/loop_task/mod.rs`)
- Agent loop → Checkpoints: manages (evidence: `src/agent/loop_task/mod.rs`)
- Terminal UI → Session history: manages (evidence: `src/tui/app/mod.rs`)
- Agent loop → Diary: uses (evidence: `src/agent/loop_task/mod.rs`)
- Prompt assembly → Diary: includes (evidence: `src/prompts/mod.rs`)
- Prompt assembly → Plan operations: renders (evidence: `src/prompts/mod.rs`)
- Terminal UI → Prompt assembly: assembles (evidence: `src/tui/app/mod.rs`)
- Prompt assembly → Configuration: reads (evidence: `src/prompts/mod.rs`)
- Model providers → Configuration: resolves (evidence: `src/providers/mod.rs`)
- Project graph indexing → Knowledge graph store: indexes (evidence: `src/agent/graph_index.rs`)
- Project graph indexing → Graph language analysis: uses (evidence: `src/agent/graph_index.rs`)
- Project files → Project graph indexing: supplies files
- Tool registry → Project files: edits
- Agent loop → Durable memory: uses (evidence: `src/agent/loop_task/mod.rs`)
