OpenClaw-first orchestration CLI for tracked, multi-agent execution.
Zigrix turns ad-hoc delegation into a visible workflow with specialist routing, evidence collection, and reportable finalization.
Why Zigrix · Is Zigrix for you? · Quick Start · Core Workflow · OpenClaw Integration · Dashboard · Docs
Most agent-heavy workflows break down in the same places:
- work gets delegated, but not consistently tracked
- specialist routing depends on memory, not policy
- outputs arrive without structured evidence
- final reporting is manual and hard to audit
Zigrix gives that flow a control surface: dispatch, worker lifecycle, evidence, and finalization in one runtime.
Zigrix is a strong fit if you want:
- one-time operator setup, then agent-driven execution
- repeatable orchestration rules instead of ad-hoc delegation
- recoverable local runtime state for task progress and reports
- OpenClaw compatibility without requiring a plugin-based architecture
Zigrix may be a poor fit if your main goal is a hosted, multi-tenant control plane.
- Operating systems: macOS, Linux
- Runtime: Node.js (current LTS recommended)
- Package manager: npm
- OpenClaw: optional, but recommended for full orchestration flow
Zigrix still works as a standalone CLI when OpenClaw is not installed.
npm install -g zigrixFrom source:
./install.shzigrix onboardzigrix doctor
zigrix dashboardThat is the intended entry flow: install → onboard → done.
| Role | Primary responsibility |
|---|---|
| Human operator | Install Zigrix, run zigrix onboard, verify readiness (zigrix doctor), then step out of day-to-day orchestration |
| OpenClaw / automation agents | Run task/worker/evidence/report commands to execute and complete orchestration work |
| Human (maintenance mode) | Use zigrix configure or zigrix reset only when reconfiguration or recovery is needed |
This split keeps normal operation agent-driven while keeping setup and governance human-controlled.
Typical operational flow:
Human setup
install -> zigrix onboard -> doctor check
Agent execution
zigrix task dispatch
-> worker prepare/register/complete
-> evidence collect/merge
-> task finalize + report
Common commands:
# Dispatch orchestration work
zigrix task dispatch --title "Implement auth module" --description "..." --scale normal --json
# Check runtime health
zigrix doctor
# Launch dashboard
zigrix dashboard --port 3838
# Maintenance surfaces
zigrix configure --section agents
zigrix configure --section skills
zigrix reset state --yeszigrix onboard prepares runtime and integration in one pass:
- creates runtime directories from
zigrix.config.json(paths.*) and default config/state structure - seeds rule files from bundled templates
- ensures
zigrixis reachable from the runtime-visible PATH - detects OpenClaw and imports agents from
openclaw.json - registers bundled
skills/zigrix-*into~/.openclaw/skills/ - leaves the environment ready for agent-led orchestration
When OpenClaw is present, Zigrix is optimized for this model:
- import agent definitions and normalize roles
- establish orchestrator ownership for task execution
- register Zigrix skill packs for agent readiness checks
- keep CLI reachability stable for OpenClaw runtime
Read the full integration contract in docs/openclaw-integration.md.
Zigrix ships with a built-in dashboard for real-time visibility into task orchestration.
zigrix dashboard --port 3838Track execution units, evidence submissions, and spec previews — all in one view.
Every state change is recorded as an immutable event — from dispatch through finalization.
Monitor in-progress tasks with real-time execution unit status and one-click cancellation.
Full task specification with metadata, scope definition, and routing rules — visible before and during execution.
See CONTRIBUTING.md.
See SUPPORT.md.
See SECURITY.md.
Apache-2.0