Where do I…?

When to read this: You know the task but not which file or doc to open. This page is the index of the how-to guides; each guide follows the same shape (goal, prerequisites, steps, verify, checklist, common mistakes).

flowchart TD
  Start[What do you need?] --> UI{Change UI?}
  UI -->|Desktop view| V["chatty-gpui/src/chatty/views/ · add-gpui-view.md"]
  UI -->|Settings page| S["chatty-gpui/src/settings/views/"]
  UI -->|Terminal UI| T["chatty-tui/src/ui/"]
  UI -->|Slash command| SC["add-slash-command.md"]
  UI -->|No| LLM{Change LLM behavior?}
  LLM -->|New tool| Tool["chatty-core/src/tools/ · first-change.md"]
  LLM -->|New provider| Prov["ProviderType + agent_factory/ · add-provider.md"]
  LLM -->|Stream bug| SM["stream-manager.md · debug.md"]
  LLM -->|WASM plugin| WASM["build-wasm-module.md + tutorials"]
  LLM -->|No| Data{Change data/settings?}
  Data -->|New setting| Set["settings/models + repositories + GPUI settings"]
  Data -->|Persistence| Repo["repositories/ or settings/repositories/"]
  Data -->|No| Infra{CI / docs / release?}
  Infra --> WF[".github/workflows/ · ci-reference.md"]
  Infra --> Doc["docs/ + docs-site/ · contribute-docs.md"]
  Infra --> Rel["RELEASE_PROCESS.md"]

How-to guides

Tutorials (learn by building) live under Start here: your first change, write a plugin (echo), give an agent the plugin (benford).

Cheat sheet