How covibes/zeroshot works
Zeroshot is a native software-engineering agent that executes authored workflow graphs: a goal is admitted, graph transitions dispatch workers, independent reviews can trigger bounded repair, and accepted work can proceed through delivery. Runs are observable and durable, with local, self-hosted, and cloud target options; the browser UI edits profiles and inspects runs. The README documents the principal workflow and target capabilities; sampled Rust excerpts clarify admission, supervision, execution, and persistence, but do not expose every target or delivery implementation detail.
Main entry points: native_v2_supervisor.rs Run supervisor · main.rs Native CLI · native_v2_admission.rs Run admission · controller.rs Portable controller
Components 19
Authoring and clients
- Native CLI
zeroshot/src/main.rs - Workspace UI
ui/src/App.tsx - Python client
sdks/python/src/zeroshot/client.py
Run orchestration
- Authored graph
zeroshot/src/full_v1_reducer.rs - Run admission
zeroshot/src/native_v2_admission.rs - Graph verifier
crates/openengine-cluster-server/src/graph_verifier.rs - Run supervisor
zeroshot/src/native_v2_supervisor.rs - Portable controller
zeroshot/src/native_v2_portable_controller/controller.rs - Run ledger
zeroshot/src/v2_run_ledger
Worker execution and delivery
- Node runner
zeroshot/src/native_v2_runner.rs - Provider processes
zeroshot/src/execution/process.rs - Git delivery
zeroshot/src/native_v2_delivery.rs
Targets and protocols
- Local target
zeroshot/src/native_v2_portable_controller.rs - Cloud target
zeroshot/src/native_v2_cloud.rs - Cluster protocol
crates/openengine-cluster-protocol/src/lib.rs - Cluster client
crates/openengine-cluster-client/src/lib.rs - Cluster server
crates/openengine-cluster-server/src/connection.rs
Other components
- Engineer
- GitHub
Connections 21
- Engineer → Native CLI: submits goal
README.md - Engineer → Workspace UI: edits profiles
README.md - Engineer → Python client: submits runs
sdks/python/src/zeroshot/client.py - Native CLI → Run admission: starts run
- Workspace UI → Native CLI: uses profiles
- Run admission → Graph verifier: validates graph
zeroshot/src/native_v2_admission.rs - Run admission → Authored graph: admits graph
zeroshot/src/native_v2_admission.rs - Portable controller → Run admission: admits submission
zeroshot/src/native_v2_portable_controller/controller.rs - Portable controller → Run supervisor: starts supervision
zeroshot/src/native_v2_portable_controller/controller.rs - Run supervisor → Authored graph: reduces history
zeroshot/src/native_v2_supervisor.rs - Run supervisor → Run ledger: reads and appends
zeroshot/src/native_v2_supervisor.rs - Run supervisor → Node runner: dispatches nodes
zeroshot/src/native_v2_supervisor.rs - Node runner → Provider processes: runs providers
- Run supervisor → Git delivery: dispatches delivery
zeroshot/src/native_v2_supervisor.rs - Local target → Portable controller: hosts runs
zeroshot/src/native_v2_portable_controller.rs - Cloud target → Portable controller: hosts runs
zeroshot/src/native_v2_cloud.rs - Cloud target → Run ledger: stores run state
zeroshot/src/native_v2_cloud.rs - Git delivery → GitHub: delivers changes
README.md - Native CLI → Cluster client: connects to target
- Cluster client → Cluster protocol: exchanges messages
- Cluster server → Cluster protocol: handles messages