How morganlowe/kodiak works
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: pipeline.rs AI Pipeline · lib.rs Tauri Backend · sync_api.py Wiki Control API · build_wiki.py AI Documentation Builder
Components 25
Desktop Workbench
- Desktop UI
src/main.ts
Task Orchestration
- Tauri Backend
src-tauri/src/lib.rs - AI Pipeline
src-tauri/src/pipeline.rs - Prompt Assembly
src-tauri/src/prompts.rs - Task Queue
src-tauri/src/queue.rs - Live Events
src-tauri/src/events.rs - Hardware Discovery
src-tauri/src/hardware.rs
Safety and Records
- App Configuration
src-tauri/src/config.rs - Permission Enforcer
src-tauri/src/enforcer.rs - Scoped Memory
src-tauri/src/memory.rs - Task History
src-tauri/src/history.rs - Run Logs
src-tauri/src/run_log.rs - Action Inbox
src-tauri/src/inbox.rs - Data Migration
src-tauri/src/migration.rs
ProjectsWiki
- Wiki Configuration
ProjectsWiki/wiki_config.py - AI Documentation Builder
ProjectsWiki/build_wiki.py - Catalog Generator
ProjectsWiki/make_wiki.py
Wiki Services
- Wiki Control API
ProjectsWiki/sync_api.py - Wiki Server
ProjectsWiki/wiki_server.py
Other components
- Developer
- Ollama
- Cloud Providers
- Project Files
- Wiki User
- MkDocs Portal
Connections 33
- Developer → Desktop UI: submits task
README.md - Desktop UI → Tauri Backend: invokes commands
- Tauri Backend → AI Pipeline: runs tasks
src-tauri/src/lib.rs - Tauri Backend → Task Queue: starts queue worker
src-tauri/src/lib.rs - AI Pipeline → Prompt Assembly: assembles prompts
src-tauri/src/pipeline.rs - AI Pipeline → Permission Enforcer: checks actions
src-tauri/src/pipeline.rs - AI Pipeline → Scoped Memory: loads context
src-tauri/src/pipeline.rs - AI Pipeline → Ollama: delegates execution
README.md - AI Pipeline → Cloud Providers: requests planning
README.md - Cloud Providers → AI Pipeline: returns plan
README.md - AI Pipeline → Developer: requests approval
README.md - AI Pipeline → Project Files: reads and applies
README.md - AI Pipeline → Task History: records task
src-tauri/src/pipeline.rs - AI Pipeline → Run Logs: logs run
src-tauri/src/pipeline.rs - AI Pipeline → Live Events: emits updates
src-tauri/src/pipeline.rs - Task Queue → Live Events: emits queue events
src-tauri/src/queue.rs - Tauri Backend → Action Inbox: manages approvals
src-tauri/src/lib.rs - Tauri Backend → App Configuration: loads settings
src-tauri/src/lib.rs - App Configuration → Hardware Discovery: resolves hardware settings
src-tauri/src/config.rs - Tauri Backend → Data Migration: runs migration
src-tauri/src/lib.rs - Wiki User → Wiki Control API: requests build or tune
ProjectsWiki/sync_api.py - Wiki Control API → Wiki Configuration: loads settings
ProjectsWiki/sync_api.py - Wiki Control API → AI Documentation Builder: triggers build
ProjectsWiki/sync_api.py - Wiki Control API → Catalog Generator: triggers catalog sync
ProjectsWiki/sync_api.py - AI Documentation Builder → Wiki Configuration: loads settings
ProjectsWiki/build_wiki.py - AI Documentation Builder → Project Files: samples project files
ProjectsWiki/build_wiki.py - AI Documentation Builder → Ollama: generates documentation
ProjectsWiki/build_wiki.py - Catalog Generator → Wiki Configuration: loads settings
ProjectsWiki/make_wiki.py - Catalog Generator → Project Files: catalogs projects
ProjectsWiki/make_wiki.py - Wiki Server → Wiki Configuration: loads settings
ProjectsWiki/wiki_server.py - Wiki Server → Wiki Control API: hosts control API
ProjectsWiki/wiki_server.py - Wiki Server → MkDocs Portal: serves knowledge portal
- Wiki User → MkDocs Portal: browses documentation
README.md