AxoFlow

TUI-first orchestration layer for coding agents.

   ┌──────────────────────────────────────┐
   │   ><(((º>    A x o F l o w          │
   │   coding agent orchestration         │
   └──────────────────────────────────────┘

AxoFlow is a terminal-native control center for coding agent orchestration. Scan your repo, build structured plans, and route execution to downstream agents like Cursor CLI, Claude Code, or OpenCode — all from a polished TUI.

Local-first. Repo-aware. Open source.

Quick start

# Build from source
git clone https://github.com/axoflow/axoflow.git
cd axoflow
go mod tidy
make build

# Initialize in your project
cd /path/to/your/project
axoflow init

# Launch the TUI
axoflow

Features

• TUI-first — Full interactive terminal UI built with Bubble Tea and Lip Gloss
• Repo scanning — Detects languages, frameworks, package managers, build commands
• Plan generation — Turns goals into structured multi-step execution plans
• Adapter system — Pluggable routing to Cursor CLI, Claude Code, OpenCode, and more
• Run tracking — Persists plans, runs, and events in local SQLite
• Policy engine — Approval gates, destructive command blocking, path restrictions
• Skills — Reusable prompt templates for common tasks
• Replay — Full event stream replay for any past run

CLI commands

Command	Description
axoflow	Launch the interactive TUI
axoflow init	Initialize AxoFlow in the current repo
axoflow doctor	Check environment and adapter health
axoflow scan	Scan the current repo and print summary
axoflow plan "<goal>"	Create a structured execution plan
axoflow run "<goal>"	Plan and execute through an adapter
axoflow adapters list	List registered adapters
axoflow adapters test	Test adapter detection and health
axoflow replay <run-id>	Replay events from a past run
axoflow skills list	List stored skills
axoflow policy show	Show current policy configuration

TUI keybindings

Key	Action
q	Quit
s	Scan workspace
p	Create a plan (enter goal)
r	Execute current plan
a	Refresh adapters
Tab	Cycle panel focus
?	Show help

Architecture

cmd/axoflow/           CLI entrypoint (Cobra)
internal/
  tui/                 Bubble Tea TUI
  config/              Config loading/saving
  db/                  SQLite persistence
  models/              Core data types
  adapters/            Adapter interface + implementations
  repo/                Repository scanner
  planner/             Plan generation
  runs/                Run execution engine
  policy/              Policy enforcement
  skills/              Skill management
  logs/                Event logging and replay
adapters/
  sdk-typescript/      TypeScript adapter SDK

Adapters

AxoFlow ships with adapters for:

• Cursor CLI — Cursor's command-line interface
• Claude Code — Anthropic's Claude coding agent
• OpenCode — Open-source coding agent

Adapters implement a simple interface: detect, healthcheck, capabilities, prompt building, and step execution. See the TypeScript SDK or Go adapter interface to build your own.

Policy

AxoFlow enforces safety policies by default:

• Require approval before file writes
• Block destructive commands (rm -rf, force push, etc.)
• Local-only mode — no external network calls
• Path allowlist/blocklist for fine-grained control

See axoflow policy show or the example config.

Tech stack

• Go — Core CLI and engine
• Cobra — CLI framework
• Bubble Tea — TUI framework
• Lip Gloss — TUI styling
• SQLite — Local persistence
• TypeScript + Zod — Adapter SDK and validation

Development

make build     # Build binary
make test      # Run tests
make tidy      # Tidy Go modules
make run       # Run without building
make doctor    # Check environment

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.