comanda

comanda

Declarative AI workflows for the command line.

Comanda turns repeatable AI work into YAML pipelines you can run, review, and version control. Use it to generate workflows from natural language, run multi-model pipelines, orchestrate agentic loops, process files, call tools, and wire Claude Code, Gemini CLI, OpenAI Codex, and API models together.

For the full guide, feature tour, and copy-ready workflow templates, start at comanda.sh:

• Features
• Templates
• GitHub examples

Install

brew install kris-hansen/comanda/comanda

Or install with Go:

go install github.com/kris-hansen/comanda@latest

See GitHub Releases for prebuilt binaries.

Quick Start

comanda configure
comanda generate workflow.yaml "review this code for bugs"
comanda process workflow.yaml

Pipe input through a workflow:

cat main.go | comanda process workflow.yaml

Inspect or iterate on a workflow:

comanda chart workflow.yaml
comanda improve workflow.yaml "Add security findings and suggested fixes"

Minimal Workflow

summarize:
  input: STDIN
  model: gpt-4o
  action: "Summarize the input in three bullets."
  output: STDOUT

Run it:

cat notes.md | comanda process summarize.yaml

What You Can Build

• Multi-agent reviews with Claude Code, Gemini CLI, OpenAI Codex, and API models
• Agentic loops that iterate until work is complete
• File, URL, image, PDF, database, and batch-processing workflows
• Tool-enabled workflows with explicit command allowlists
• Codebase indexes for persistent project context
• Git worktree workflows for parallel isolated implementation
• Server-backed workflows callable over HTTP

More Examples

Most examples and walkthroughs live on comanda.sh:

• Browse workflow templates
• Explore all features
• Local examples directory
• Multi-agent patterns
• Agentic loops
• Tool use
• Server API

Development

make deps
make build
make test

License

MIT

Download History