Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Push decisions to Arbiter Zebu for async human review. Use when you need human input on plans, architectural choices, or approval before proceeding.
Push decisions to Arbiter Zebu for async human review. Use when you need human input on plans, architectural choices, or approval before proceeding.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Push decisions to Arbiter Zebu for async human review. Use when you need human input on plans, architectural choices, or approval before proceeding.
Quick install via ClawHub: clawhub install arbiter Or via bun (makes CLI commands available globally): bun add -g arbiter-skill Or manual: git clone https://github.com/5hanth/arbiter-skill.git cd arbiter-skill && npm install && npm run build ln -s $(pwd) ~/.clawdbot/skills/arbiter
Arbiter Zebu bot running (or just bunx arbiter-zebu) ~/.arbiter/queue/ directory (created automatically by the bot)
Set these in your agent's environment for automatic agent/session detection: VariableDescriptionExampleCLAWDBOT_AGENTAgent IDceo, swe1CLAWDBOT_SESSIONSession keyagent:ceo:main
Plan review before implementation Architectural decisions with tradeoffs Anything blocking that needs human judgment Multiple related decisions as a batch Do NOT use for: Simple yes/no that doesn't need explanation Urgent real-time decisions (use direct message instead) Technical questions you can research yourself
Create a decision plan for human review. CLI: arbiter-push '<json>' โ takes a single JSON argument containing all fields. arbiter-push '{ "title": "API Design Decisions", "tag": "nft-marketplace", "context": "SWE2 needs these decided before API work", "priority": "normal", "notify": "agent:swe2:main", "decisions": [ { "id": "auth-strategy", "title": "Auth Strategy", "context": "How to authenticate admin users", "options": [ {"key": "jwt", "label": "JWT tokens", "note": "Stateless"}, {"key": "session", "label": "Sessions", "note": "More control"}, {"key": "oauth", "label": "OAuth", "note": "External provider"} ] }, { "id": "database", "title": "Database Choice", "context": "Primary datastore", "options": [ {"key": "postgresql", "label": "PostgreSQL + JSONB"}, {"key": "mongodb", "label": "MongoDB"} ], "allowCustom": true } ] }' JSON Fields: FieldRequiredDescriptiontitleYesPlan titletagNoTag for filtering (e.g., project name)contextNoBackground for reviewerpriorityNolow, normal, high, urgent (default: normal)notifyNoSession to notify when completeagentNoAgent ID (auto-detected from CLAWDBOT_AGENT env)sessionNoSession key (auto-detected from CLAWDBOT_SESSION env)decisionsYesArray of decisions Decision object: FieldRequiredDescriptionidYesUnique ID within plantitleYesDecision titlecontextNoExplanation for revieweroptionsYesArray of {key, label, note?}allowCustomNoAllow free-text answer (default: false)defaultNoSuggested option key Returns: { "planId": "abc123", "file": "~/.arbiter/queue/pending/ceo-api-design-abc123.md", "total": 2, "status": "pending" }
Check the status of a decision plan. CLI: arbiter-status <plan-id> or arbiter-status --tag <tag> arbiter-status abc12345 # or arbiter-status --tag nft-marketplace Returns: { "planId": "abc123", "title": "API Design Decisions", "status": "in_progress", "total": 3, "answered": 1, "remaining": 2, "decisions": { "auth-strategy": {"status": "answered", "answer": "jwt"}, "database": {"status": "pending", "answer": null}, "caching": {"status": "pending", "answer": null} } }
Get answers from a completed plan. CLI: arbiter-get <plan-id> or arbiter-get --tag <tag> arbiter-get abc12345 # or arbiter-get --tag nft-marketplace Returns: { "planId": "abc123", "status": "completed", "completedAt": "2026-01-30T01:45:00Z", "answers": { "auth-strategy": "jwt", "database": "postgresql", "caching": "redis" } } Error if not complete: { "error": "Plan not complete", "status": "in_progress", "remaining": 2 }
Block until plan is complete (with timeout). arbiter-await abc12345 --timeout 3600 Polls every 30 seconds until complete or timeout. Returns: Same as arbiter_get on completion.
# Push plan decisions (single JSON argument) RESULT=$(arbiter-push '{"title":"Clean IT i18n Plan","tag":"clean-it","priority":"high","notify":"agent:swe3:main","decisions":[{"id":"library","title":"i18n Library","options":[{"key":"i18next","label":"i18next"},{"key":"formatjs","label":"FormatJS"}]},{"id":"keys","title":"Key Structure","options":[{"key":"flat","label":"Flat (login.button)"},{"key":"nested","label":"Nested ({login:{button}})"}]}]}') PLAN_ID=$(echo $RESULT | jq -r '.planId') echo "Pushed plan $PLAN_ID โ waiting for human review"
# Check if decisions are ready STATUS=$(arbiter-status --tag nft-marketplace) if [ "$(echo $STATUS | jq -r '.status')" == "completed" ]; then ANSWERS=$(arbiter-get --tag nft-marketplace) AUTH=$(echo $ANSWERS | jq -r '.answers["auth-strategy"]') echo "Using auth strategy: $AUTH" # Proceed with implementation else echo "Still waiting for $(echo $STATUS | jq -r '.remaining') decisions" fi
# Wait up to 1 hour for decisions ANSWERS=$(arbiter-await abc12345 --timeout 3600) if [ $? -eq 0 ]; then # Got answers, proceed echo "Decisions ready: $ANSWERS" else echo "Timeout waiting for decisions" fi
Batch related decisions โ Don't push one at a time Provide context โ Human needs to understand tradeoffs Use tags โ Makes filtering easy (--tag project-name) Set notify โ So blocked agents get woken up Use priority sparingly โ Reserve urgent for true blockers
PathPurpose~/.arbiter/queue/pending/Plans awaiting review~/.arbiter/queue/completed/Answered plans (archive)~/.arbiter/queue/notify/Agent notifications
In your HEARTBEAT.md, add: ## Check Arbiter Notifications 1. Check if `~/.arbiter/queue/notify/` has files for my session 2. If yes, read answers and proceed with blocked work 3. Delete notification file after processing
IssueSolutionPlan not showing in ArbiterCheck file is valid YAML frontmatterAnswers not appearingCheck arbiter_status, may be incompleteNotification not receivedEnsure --notify was set correctly
Arbiter Zebu Architecture Arbiter Zebu Bot
Writing, remixing, publishing, visual generation, and marketing content production.
Largest current source with strong distribution and engagement signals.