Product tour
Tour what is built — and what is not
Every movement and step carries a visible BUILT, PARTIAL, or VISION label. Start with the downloadable local product; treat the roadmap as roadmap.
BuiltPartialVision
PreludeBUILTInstall the local execution surface
GoatFish's desktop artifact carries a local server, and you can point the client at an environment on another machine instead. Provider sessions use the provider runtimes and accounts on whichever machine runs the server you selected.
- BUILT
Download first
Start at /download and choose the desktop artifact for your platform. New installers use Goatfish-* filenames; earlier builds retain their original names.
- BUILT
Bring a provider CLI
Install and authenticate a supported provider such as Codex, Claude, Cursor, OpenCode, Auggie, or Grok. GoatFish detects and runs those provider runtimes on the machine its server runs on.
- BUILT
Keep the boundary clear
The operations server is yours — local or remote — but model work is not provider-free: prompts and selected code or context go from the provider CLI to the provider you chose.
IBUILTChoose the working practice
Domain kits and TDD are implemented as settings and generated instructions that flow into fresh sessions and swarm roles.
- BUILT
Pick a domain
Settings → Skills includes seven built-in domain presets plus per-project overrides. The selected guidance is injected into each fresh session.
- BUILT
Apply a domain kit
Applying a kit writes marker-managed workspace instructions and a project-wiki outline. User-authored content outside the managed markers is preserved.
- BUILT
Enable TDD
The TDD toggle injects red-green-refactor discipline into fresh sessions, domain kits, swarm instructions, and specialist role files.
IIBUILTConfigure swarm controls
GoatFish exposes presets, provider-qualified routes, a worker policy, and five specialist workflow roles.
- BUILT
Select a preset and roles
Settings → Swarm configures an orchestrator, worker policy, and scout, implementer, reviewer, test-writer, and validator roles.
- BUILT
Choose provider-qualified routes
The orchestrator and role controls name both model and provider route. Host-created child sessions can start on the selected provider instance.
- PARTIAL
Understand the enforcement limit
GoatFish can pin host-created threads and inject mandatory route instructions. Routing inside a provider's own native subagents remains instruction-level.
IIIBUILTWatch and steer the subagent tree
Cross-provider children are real nested threads with their own runtime status and activity stream.
- BUILT
Expand nested work
The sidebar renders child sessions under their parent with running, completed, failed, or declined status and preserves previous context-clear epochs.
- BUILT
Open the watch view
A child's view shows the dispatched prompt, streamed assistant text, reasoning-derived activity, tool work, and final result.
- BUILT
Steer or interrupt
Send a queued follow-up or interrupt a child's in-flight turn before delivering urgent direction. The UI and orchestration layer track the child as its own session.
IVBUILTContinue and remember
Self-handoff and the project wiki are operational local features; neither depends on HiveMind.
- BUILT
Hand off to fresh context
A top-level agent calls agi_handoff as its last action with a complete continuation brief. When the turn ends, GoatFish clears that session's context and starts a fresh turn with the configured handoff preamble plus only that brief.
- BUILT
Use repo-scoped memory
Read, search, create, edit, and delete markdown in the project wiki, confined by the server to the active project root.
VPARTIALRead the security posture literally
Local-first execution is built. Content scrubbing and organization-grade governance are not.
- BUILT
Local server and pairing
The desktop shell starts a loopback-local server. Non-desktop browser clients use a one-time pairing token and then an authenticated session.
- PARTIAL
Content security is a stub
The current switch persists intent, but the promised deterministic scrub-and-restore parser is not wired into provider payloads.
- VISION
Org identity and audit are not built
Organization-issued orgId, actorId, and role values remain reserved for future enrollment, and GoatFish does not provide a per-org audit trail.
CodaPARTIALKeep HiveMind separate
HiveMind and GoatFish have a planned versioned seam, not a live integrated control plane.
- PARTIAL
Fugue ↔ HiveMind is a stub
Settings → Connections includes an Experimental stub switch. It persists but performs no runtime integration.
- VISION
Ensemble dashboards are not live
HiveMind-wide dashboards for teammate agents, routes, and spend do not exist inside GoatFish today.
- BUILT
The local wiki remains useful
GoatFish's repo-scoped wiki is built and works without HiveMind; it should not be described as organization-wide memory.