Local-first multi-agent coordination and provenance for coding workflows.
AgentMesh adds deterministic coordination (claims, waits, steals), commit-linked lineage (AgentMesh-Episode trailers + weave events), and portable handoff bundles (.meshpack) on top of normal git workflows.
pipx install agentmesh-core # recommended (isolated)
# or
pip install agentmesh-core
# optional: commit witness signing (Ed25519)
pipx install "agentmesh-core[witness]"cd your-repo
agentmesh init --install-hooks # set up mesh + Claude Code hooks
agentmesh doctor # verify everything is wired correctly
agentmesh task start --title "Fix login timeout" \
--claim src/auth.py --claim tests/test_auth.py
# edit + stage as normal
git add src/auth.py tests/test_auth.py
agentmesh task finish --message "Fix login timeout handling" \
--run-tests "pytest -q tests/test_auth.py"
# ^ commits with AgentMesh-Episode trailer, emits capsule, releases claimsWhen multiple AI agents (or humans) work in the same repo, AgentMesh prevents chaos:
- Claims: agents lock files/ports/resources before editing. Conflicts are blocked, not merged.
- Episodes: every work session gets a unique ID (
ep_...) that binds claims, capsules, and commits. - Capsules: structured context bundles (SBAR format) for zero-ramp-up handoffs between agents.
- Weaver: hash-chained provenance linking capsules to git commits. Every change is traceable. Gap detection catches omissions (
WEAVE_CHAIN_BREAKevent on failure). - Witness: optional Ed25519 signing of commits and provenance records. Adds cryptographic proof of authorship.
- Commit trailers:
agentmesh commitinjectsAgentMesh-Episode:by default, and can attach signed witness trailers when witness support + keys are present.
AgentMesh integrates with Assay to produce tamper-evident evidence automatically:
- Assay Bridge: every merged or aborted task emits an
ASSAY_RECEIPTevent via subprocess call. If Assay isn't installed, the bridge degrades gracefully. - Alpha Gate: release gating with 6 checks (merged task count, witness verification, weave chain integrity, full transition receipts, watchdog handling, no orphan loss).
- Evidence KPI: nightly workflow tracking evidence pipeline health — pass rates, enforcement dates, trend history.
- Evidence Wire Protocol v0: canonical
_ewp_*identity envelope for cross-repo evidence flow.
Every PR to main must pass lineage + assay-gate + assay-verify + weave-integrity checks.
If installed with agentmesh-core[witness], you can sign commit witnesses locally:
agentmesh key generate
agentmesh commit -m "Fix timeout handling"
agentmesh witness verify HEADWitness verification is portable: the signed witness payload is embedded in commit trailers, so CI and other machines can verify without local sidecar state.
Add agentmesh-action to check lineage coverage on PRs:
# .github/workflows/lineage.yml
name: Lineage Check
on: [pull_request]
permissions:
contents: read
pull-requests: write
jobs:
lineage:
runs-on: ubuntu-latest
steps:
- uses: Haserjian/agentmesh-action@v2The action posts a sticky PR comment showing commit coverage. Set require-trailers: "true" to enforce episode lineage, and verify-witness: "true" + require-witness: "true" to enforce cryptographic witness verification. See agentmesh-action for policy profiles (baseline, strict, enterprise).
- Coordination playbook:
AGENTS.md - Public/private boundary:
docs/public-private-boundary.md - Alpha gate runbook:
docs/alpha-gate-runbook.md - Evidence Wire Protocol:
docs/evidence-wire-protocol-v0.md - License transition:
docs/license-policy.md
| Repo | Purpose |
|---|---|
| assay | Evidence compiler CLI (tamper-evident audit trails for AI) |
| assay-verify-action | GitHub Action for CI evidence verification |
| assay-ledger | Public transparency ledger |
| agentmesh-action | GitHub Action for lineage + witness checks |
AgentMesh is licensed under Apache-2.0 for current and future development.
Published releases up to and including v0.7.0 remain under MIT as originally released.