Kode CLI — Terminal AI Assistant

kode [flags]
  --relay              Relay URL (default from ~/.config/kode/config.yaml)
  --model              AI model override
  --version            Print version
  --once <prompt>      Non-interactive: send a single prompt, print reply, exit (CI/scripts)
  --once /<command>    Non-interactive: dispatch a slash command via internal/core
  --once --json …      Same, emit JSON for downstream parsing
  --help               Show usage

relay_url: wss://kode.koder.dev/v1/relay/ws
default_provider: claude
default_model: claude-opus-4-7
work_dir: ~/dev
allowed_tools:
  - shell
  - read_file
  - write_file
  - list_dir
  - install_pkg
  - env_info
context:
  git_snapshot: true
  shell_history: true
  file_watcher: true
  stderr_buffer: true
  auto_kode_md: true
  chronicle:
    enabled: false
    mode: local
    interval_turns: 5
auto_lint: false
auto_test: false
auto_commit: false
tui_skin: kode
yolo_mode: false

graph TD
    A[kode CLI] -->|WebSocket WSS| B[ai/kode/platform relay]
    B -->|REST/SSE| C[ai/gateway]
    C --> D[Claude]
    C --> E[Gemini / OpenAI / others]
    A -->|OAuth2 device flow| F[foundation/id]
    A -->|reads| G[git / shell history / files]
    A -->|stores| H[~/.config/kode/]

products/dev/kode/
  cmd/kode/main.go        Entry point — --version, --help, --once flags; kkode alias
  app/
    tui/                  Bubble Tea TUI surface (formerly internal/tui/, moved per RFC-006 §4)
      app.go              Model — UI loop, legacy slash-command switch
      styles.go           Lipgloss styles
      skins.go            TUI skin system (kode, claude, gemini, codex)
      repomap.go          /repomap codebase tree
    cli/                  One-shot non-interactive mode (DKODE-085, 2026-05-04)
      cli.go              Run() — slash via core.Dispatch, prompts via relay session
  app/
    tui/
      core_bridge.go      Wires TUI Model to internal/core dispatcher (DKODE-089)
  internal/
    core/                 UI-agnostic dispatcher (DKODE-084, 2026-05-04)
      core.go             Line, Result{Lines,ChangedFlags,Exit,Handled,Err}, State, Dispatch
      handlers_session.go /status /reset /verbose /trace /cache /dryrun /thinking-tokens /reasoning-effort /output-style
      handlers_relay.go   /usage /instructions /switch /kill /rename
      handlers_config.go  /config show|set|validate
      handlers_lifecycle.go /about /exit /quit /bye
      handlers_permissions.go /perms list|test
    permissions/             Allow/deny matcher (DKODE-092)
      matcher.go             Match(lists, verb, target) → (Decision, rule)
    tools/
      executor.go            Execute / ExecuteWithAudit (msg, allowedTools, perms, auditLog, sessionID) → consults CheckPermission, optionally appends audit JSONL line per call (DKODE-093 + DKODE-098). Denied calls fail KODE-PERM-001.
    audit/
      log.go                 JSONL forensic log at ~/.config/kode/audit/<day>.jsonl; opt-in via cfg.AuditLog (DKODE-098)
    hooks/
      hooks.go               Subprocess runtime + stdout JSON protocol + KODE-HOOK-NNN error IDs (DKODE-092)
    relay/
      client.go           WebSocket client — auth, send/recv, reconnect
      protocol.go         Wire types (mirrors services/ai/kode/platform/relay/protocol.go)
    context/
      git.go              Git snapshot
      shell.go            Shell history reader
      stderr.go           Stderr ring buffer (128 KB)
      watcher.go          File watcher (hot files, 30s poll)
      injector.go         Compose + format context snapshot
    auth/
      store.go            Credential storage (AES-256-GCM)
      oauth2.go           Device Flow + PKCE
      login.go            /login handler
    config/
      config.go           YAML config + sub-structs
      hierarchy.go        LoadHierarchical — defaults → user → workspace overlay (DKODE-043)
      folders.go          FolderStore — client-side session grouping
      kode_template.go    Default KODE.md template
    persona/
      store.go            Persona YAML storage
    hooks/
      hooks.go            Event hook runner
    tools/
      executor.go         Local tool execution (shell, file I/O)