# morganlowe/kodiak architecture

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

- Interactive diagram: https://gitdiagram.com/morganlowe/kodiak
- Repository: https://github.com/morganlowe/kodiak

## Overview

Kodiak is a local-first desktop AI development orchestrator. A user submits a scoped task in the desktop workbench; the backend plans it, checks permissions, delegates file inspection and diff drafting locally, requests approval where required, applies permitted actions, and records the run. The repository also includes a loosely coupled ProjectsWiki knowledge portal for generating, cataloguing, tuning, and serving project documentation. The README documents the principal workflow and capabilities; sampled source confirms several implementation relationships, while unsampled subsystem links are omitted where evidence is insufficient.

Main entry points: [`src-tauri/src/pipeline.rs`](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/pipeline.rs) (AI Pipeline), [`src-tauri/src/lib.rs`](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/lib.rs) (Tauri Backend), [`ProjectsWiki/sync_api.py`](https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/sync_api.py) (Wiki Control API), [`ProjectsWiki/build_wiki.py`](https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/build_wiki.py) (AI Documentation Builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop Workbench"]
  node_workbench["Desktop UI<br/>[main.ts]"]
end

subgraph group_orchestration["Task Orchestration"]
  node_tauri["Tauri Backend<br/>[lib.rs]"]
  node_pipeline["AI Pipeline<br/>[pipeline.rs]"]
  node_prompts["Prompt Assembly<br/>[prompts.rs]"]
  node_queue["Task Queue<br/>[queue.rs]"]
  node_events["Live Events<br/>[events.rs]"]
  node_hardware["Hardware Discovery<br/>[hardware.rs]"]
end

subgraph group_safety["Safety and Records"]
  node_config["App Configuration<br/>[config.rs]"]
  node_enforcer["Permission Enforcer<br/>[enforcer.rs]"]
  node_memory[("Scoped Memory<br/>[memory.rs]")]
  node_history[("Task History<br/>[history.rs]")]
  node_runlog[("Run Logs<br/>[run_log.rs]")]
  node_inbox["Action Inbox<br/>[inbox.rs]"]
  node_migration["Data Migration<br/>[migration.rs]"]
end

subgraph group_wiki["ProjectsWiki"]
  node_wiki_config["Wiki Configuration<br/>[wiki_config.py]"]
  node_wiki_builder["AI Documentation Builder<br/>[build_wiki.py]"]
  node_wiki_catalog["Catalog Generator<br/>[make_wiki.py]"]
end

subgraph group_wiki_service["Wiki Services"]
  node_wiki_api["Wiki Control API<br/>[sync_api.py]"]
  node_wiki_server["Wiki Server<br/>[wiki_server.py]"]
end

node_user(("Developer"))
node_ollama{{"Ollama"}}
node_cloud{{"Cloud Providers"}}
node_project_files[("Project Files")]
node_wiki_user(("Wiki User"))
node_mkdocs["MkDocs Portal"]

node_user -->|"submits task"| node_workbench
node_workbench -.->|"invokes commands"| node_tauri
node_tauri -->|"runs tasks"| node_pipeline
node_tauri -->|"starts queue worker"| node_queue
node_pipeline -->|"assembles prompts"| node_prompts
node_pipeline -->|"checks actions"| node_enforcer
node_pipeline -->|"loads context"| node_memory
node_pipeline -->|"delegates execution"| node_ollama
node_pipeline -->|"requests planning"| node_cloud
node_cloud -->|"returns plan"| node_pipeline
node_pipeline -->|"requests approval"| node_user
node_pipeline -->|"reads and applies"| node_project_files
node_pipeline -->|"records task"| node_history
node_pipeline -->|"logs run"| node_runlog
node_pipeline -->|"emits updates"| node_events
node_queue -->|"emits queue events"| node_events
node_tauri -->|"manages approvals"| node_inbox
node_tauri -->|"loads settings"| node_config
node_config -->|"resolves hardware settings"| node_hardware
node_tauri -.->|"runs migration"| node_migration
node_wiki_user -->|"requests build or tune"| node_wiki_api
node_wiki_api -->|"loads settings"| node_wiki_config
node_wiki_api -->|"triggers build"| node_wiki_builder
node_wiki_api -->|"triggers catalog sync"| node_wiki_catalog
node_wiki_builder -->|"loads settings"| node_wiki_config
node_wiki_builder -->|"samples project files"| node_project_files
node_wiki_builder -->|"generates documentation"| node_ollama
node_wiki_catalog -->|"loads settings"| node_wiki_config
node_wiki_catalog -->|"catalogs projects"| node_project_files
node_wiki_server -->|"loads settings"| node_wiki_config
node_wiki_server -->|"hosts control API"| node_wiki_api
node_wiki_server -.->|"serves knowledge portal"| node_mkdocs
node_wiki_user -->|"browses documentation"| node_mkdocs

click node_workbench "https://github.com/morganlowe/kodiak/blob/main/src/main.ts"
click node_tauri "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/lib.rs"
click node_pipeline "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/pipeline.rs"
click node_prompts "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/prompts.rs"
click node_queue "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/queue.rs"
click node_config "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/config.rs"
click node_enforcer "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/enforcer.rs"
click node_memory "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/memory.rs"
click node_history "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/history.rs"
click node_runlog "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/run_log.rs"
click node_events "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/events.rs"
click node_hardware "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/hardware.rs"
click node_inbox "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/inbox.rs"
click node_migration "https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/migration.rs"
click node_wiki_config "https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/wiki_config.py"
click node_wiki_builder "https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/build_wiki.py"
click node_wiki_catalog "https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/make_wiki.py"
click node_wiki_api "https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/sync_api.py"
click node_wiki_server "https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/wiki_server.py"

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_workbench,node_wiki_user toneBlue
class node_tauri,node_pipeline,node_prompts,node_queue,node_events,node_hardware,node_project_files toneAmber
class node_config,node_enforcer,node_memory,node_history,node_runlog,node_inbox,node_migration toneMint
class node_wiki_config,node_wiki_builder,node_wiki_catalog toneRose
class node_wiki_api,node_wiki_server,node_user,node_ollama,node_cloud,node_mkdocs toneIndigo
```

## Components

### Desktop Workbench

- [Desktop UI](https://github.com/morganlowe/kodiak/blob/main/src/main.ts): `src/main.ts`

### Task Orchestration

- [Tauri Backend](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [AI Pipeline](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/pipeline.rs): `src-tauri/src/pipeline.rs`
- [Prompt Assembly](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/prompts.rs): `src-tauri/src/prompts.rs`
- [Task Queue](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/queue.rs): `src-tauri/src/queue.rs`
- [Live Events](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/events.rs): `src-tauri/src/events.rs`
- [Hardware Discovery](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/hardware.rs): `src-tauri/src/hardware.rs`

### Safety and Records

- [App Configuration](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/config.rs): `src-tauri/src/config.rs`
- [Permission Enforcer](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/enforcer.rs): `src-tauri/src/enforcer.rs`
- [Scoped Memory](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/memory.rs): `src-tauri/src/memory.rs`
- [Task History](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/history.rs): `src-tauri/src/history.rs`
- [Run Logs](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/run_log.rs): `src-tauri/src/run_log.rs`
- [Action Inbox](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/inbox.rs): `src-tauri/src/inbox.rs`
- [Data Migration](https://github.com/morganlowe/kodiak/blob/main/src-tauri/src/migration.rs): `src-tauri/src/migration.rs`

### ProjectsWiki

- [Wiki Configuration](https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/wiki_config.py): `ProjectsWiki/wiki_config.py`
- [AI Documentation Builder](https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/build_wiki.py): `ProjectsWiki/build_wiki.py`
- [Catalog Generator](https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/make_wiki.py): `ProjectsWiki/make_wiki.py`

### Wiki Services

- [Wiki Control API](https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/sync_api.py): `ProjectsWiki/sync_api.py`
- [Wiki Server](https://github.com/morganlowe/kodiak/blob/main/ProjectsWiki/wiki_server.py): `ProjectsWiki/wiki_server.py`

### Other components

- **Developer**
- **Ollama**
- **Cloud Providers**
- **Project Files**
- **Wiki User**
- **MkDocs Portal**

## Connections

- Developer → Desktop UI: submits task (evidence: `README.md`)
- Desktop UI → Tauri Backend: invokes commands
- Tauri Backend → AI Pipeline: runs tasks (evidence: `src-tauri/src/lib.rs`)
- Tauri Backend → Task Queue: starts queue worker (evidence: `src-tauri/src/lib.rs`)
- AI Pipeline → Prompt Assembly: assembles prompts (evidence: `src-tauri/src/pipeline.rs`)
- AI Pipeline → Permission Enforcer: checks actions (evidence: `src-tauri/src/pipeline.rs`)
- AI Pipeline → Scoped Memory: loads context (evidence: `src-tauri/src/pipeline.rs`)
- AI Pipeline → Ollama: delegates execution (evidence: `README.md`)
- AI Pipeline → Cloud Providers: requests planning (evidence: `README.md`)
- Cloud Providers → AI Pipeline: returns plan (evidence: `README.md`)
- AI Pipeline → Developer: requests approval (evidence: `README.md`)
- AI Pipeline → Project Files: reads and applies (evidence: `README.md`)
- AI Pipeline → Task History: records task (evidence: `src-tauri/src/pipeline.rs`)
- AI Pipeline → Run Logs: logs run (evidence: `src-tauri/src/pipeline.rs`)
- AI Pipeline → Live Events: emits updates (evidence: `src-tauri/src/pipeline.rs`)
- Task Queue → Live Events: emits queue events (evidence: `src-tauri/src/queue.rs`)
- Tauri Backend → Action Inbox: manages approvals (evidence: `src-tauri/src/lib.rs`)
- Tauri Backend → App Configuration: loads settings (evidence: `src-tauri/src/lib.rs`)
- App Configuration → Hardware Discovery: resolves hardware settings (evidence: `src-tauri/src/config.rs`)
- Tauri Backend → Data Migration: runs migration (evidence: `src-tauri/src/lib.rs`)
- Wiki User → Wiki Control API: requests build or tune (evidence: `ProjectsWiki/sync_api.py`)
- Wiki Control API → Wiki Configuration: loads settings (evidence: `ProjectsWiki/sync_api.py`)
- Wiki Control API → AI Documentation Builder: triggers build (evidence: `ProjectsWiki/sync_api.py`)
- Wiki Control API → Catalog Generator: triggers catalog sync (evidence: `ProjectsWiki/sync_api.py`)
- AI Documentation Builder → Wiki Configuration: loads settings (evidence: `ProjectsWiki/build_wiki.py`)
- AI Documentation Builder → Project Files: samples project files (evidence: `ProjectsWiki/build_wiki.py`)
- AI Documentation Builder → Ollama: generates documentation (evidence: `ProjectsWiki/build_wiki.py`)
- Catalog Generator → Wiki Configuration: loads settings (evidence: `ProjectsWiki/make_wiki.py`)
- Catalog Generator → Project Files: catalogs projects (evidence: `ProjectsWiki/make_wiki.py`)
- Wiki Server → Wiki Configuration: loads settings (evidence: `ProjectsWiki/wiki_server.py`)
- Wiki Server → Wiki Control API: hosts control API (evidence: `ProjectsWiki/wiki_server.py`)
- Wiki Server → MkDocs Portal: serves knowledge portal
- Wiki User → MkDocs Portal: browses documentation (evidence: `README.md`)
