Orca

Offline/CLI-first orchestration engine inspired by HashiCorp Nomad, far simpler than Kubernetes.

Status

v0.1: Foundation — see .ciagent/ROADMAP.md for the 6-phase plan.

Pillars

Simplicity — single binary, minimal dependencies
AI-first — CLI designed for both humans and AI agents
Offline-first — no cloud dependencies
CLI-first — primary interface is the command line
Security before features — NFRs ship before new functionality
Bug fixes before features — stability is paramount
NFRs before features — observability and auditability first

Quickstart

# Build
make build

# Run
./bin/orca version
./bin/orca --help

# Initialize local state
./bin/orca init

Subcommands

Command	Description	Status
`orca version`	Print version info	✅ Phase 1
`orca init`	Initialize local orca state	✅ Phase 1 (stub)
`orca status`	Show orca daemon status	✅ Phase 1 (stub)
`orca node`	Node management (`join`, `leave`, `list`)	Phase 2
`orca job`	Job management (`run`, `list`, `stop`, `logs`)	Phase 3

Development

make build      # Build binary to ./bin/orca
make test       # Run tests with race detection
make lint       # Run golangci-lint
make fmt        # Format code
make release    # Build + create Gitea release (Phase 6)

Architecture

See .ciagent/ARCHITECTURE.md for full architecture details.

License

MIT — see LICENSE.

1.6 KiB Raw Blame History