Documentation

Every layer of Goa is documented — from the high-level architecture down to individual tools, skills, and profiles.

Goa Architecture
How the TUI, core engine, agent SDK and provider layer fit together.
architecture
Setup Guide
Install Goa, run the first-run wizard and connect a provider.
setup
Configuration
The config cascade: embedded, home, project, local, env, CLI.
configuration
Command System
Reference for every slash command in the TUI.
commands
Tool System
The composable tool registry: read, edit, bash, search, SSH and more.
tools
Skills System
Reusable prompt templates, inline or as sub-agents.
skills
Agent Modes
Built-in coder, planner and reviewer profiles, plus custom ones.
profiles
TUI (Terminal User Interface)
The ANSI-native UI: components, rendering and keybindings.
tui
Agent SDK
The Agent SDK: agents, sessions and the event model.
agentic-sdk
JS Extensions (Plugins)
Extend Goa with JavaScript plugins via the Goja runtime.
plugins
Goa Provider Configuration
OpenAI-compatible endpoints: OpenAI, llama.cpp, LM Studio, Ollama.
providers
Workflows
Pair (planner to coder) and reviewer collaboration pipelines.
workflows
Orchestration — MICROSTEP execution plan (separate session)
Design notes for multi-agent orchestration.
orchestration-design
Orchestrator
Run multi-agent workflows: hub/fanout/pipeline topologies with goal binding.
orchestrator
Skill Execution Specification
How skills run: inline injection vs sub-agent dispatch.
skill-execution
Development Guide
Building, testing and contributing to Goa.
development
Profiling Goa
Profiling and performance tooling for Goa.
profiling
Goals
Project goals, roadmap and direction.
goals
Keyboard Shortcuts
Every keyboard shortcut, in the terminal, in the browser and over attach.
hotkeys
Provider Connectivity
HTTP connectivity details for every provider adapter.
provider-connectivity
Provider Prompt Cache — Design & Forensics
How Goa drives the LLM provider's prompt cache, how a "cache miss" is defined
provider-cache
Plan Mode
Plan mode: structured, event-sourced work planning.
plan
MCP — Model Context Protocol Servers
Goa is an MCP client. Connect MCP servers and their tools become available to
mcp
Loop detection
The five stuck-agent heuristics and their safeguards.
loop-detection
Teams of Agents — MICROSTEP execution plan
Branch: feature/team (created; spec committed as 78cc5af). Spec:
teams-plan
Teams of Agents — Specification (DRAFT for review)
Status: proposal — not implemented. This document specifies named, reusable
teams
Limits & Defaults Reference
Every hard limit, threshold, timeout and built-in default Goa applies, grouped by area.
limits
TUI Rework — feature/tui-rework
Autonomous fix branch for rendering/streaming/tooling issues found via session-log
tui-rework-progress
Spec: Explicit Handover Between Goals (clean-context continuity)
Goal: make continuity between goals explicit so the default freshContext: true (clean agent) is always safe and sufficient — the handover, not the conversa...
handover-spec
Goa User Guide
Task-driven guide: workflows, orchestrator, companion, the web UI and images.
user-guide
Goa Web UI (`goa server`)
The web UI and terminal interop: goa server, goa attach, multi-project serving.
webui
Goa — Command-Line Manual
Goa is a terminal-native AI coding agent. Started with no arguments it opens the
cli
golang-check Fix Plan — 2026-08-26
Source: full run of .agents/skills/golang-check/golang-check.sh (gocognit >15, gocyclo >12, staticcheck, file-size hard 1000 / soft 500).
golang-check-20260826-fix-plan
Plan: More Codex Optimizations for Goa
Branch: feature/more-codex
plan-more-codex
Web UI rendering — measured assessment and design
Date: 2026-10-04
webui-perf-assessment