Evotown Handoff

If you're running multiple Claude instances across different teams or engines and need structured handoffs instead of ad-hoc chat messages, this queues work through Evotown's control plane. You POST a handoff job specifying a target team (like finance) or a specific engine (like hermes-bob), and their Connector picks it up and triggers their local gateway. The CLI wraps the HTTP API and needs EVOTOWN_INGEST_TOKEN to authenticate. One thing to remember is you're responsible for calling complete when the job finishes, the webhook alone won't close the loop. It's orchestration infrastructure, so you'll need Evotown already deployed and multiple registered agents for this to make sense.

GitHub stars: 896
last updated: Jun 11, 2026

View on GitHub

Install

$ npx -y skills add exboys/evotown --skill evotown-handoff --agent claude-code

Installs into .claude/skills of the current project.

Files

Evotown handoff

When a task should continue on another engine or team, do not message them in chat directly. Queue a handoff on Evotown.

CLI (employee machine)

evotown-agent-setup.py handoff \
  --to-team finance \
  --title "Expense review" \
  --message "Please verify the summary and approve or reject."

Or target a specific engine:

evotown-agent-setup.py handoff --to-engine hermes-bob --message "..."

Requires EVOTOWN_INGEST_TOKEN and prior register.

HTTP (from automation)

POST {EVOTOWN_URL}/api/v1/jobs/from-engine
Authorization: Bearer {EVOTOWN_INGEST_TOKEN}

{
  "kind": "handoff",
  "source_engine_id": "openclaw-alice",
  "target_team_id": "finance",
  "title": "Handoff",
  "message": "..."
}

The receiving machine's Connector will lease the job and trigger local OpenClaw/Hermes Gateway.

Load the evotown-dispatch-complete skill when executing Evotown dispatch jobs.

When this agent finishes the leased job, report completion (do not rely on hook HTTP alone):

evotown-agent-setup.py complete --job-id <job_id from task payload> --status succeeded --summary "..."

SKILL.md on GitHub

Details

Repository: github.com/exboys/evotown
Categories: Backend & APIs, AI & Agent Building
First seen: Jun 11, 2026