Skip to content
rohansiddamPublic

About

Synthe: dependency-free checker that validates agent-to-agent handoff packets (artifact freshness by hash, required evidence, approvals, no duplicate execution) before the receiving agent starts. GitHub Action included.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Synthe

The commit barrier for AI agents. Agents propose. You approve. Synthe pushes exactly the commit you approved, and writes a signed receipt anyone can verify.

An AI agent with a GitHub token can push whatever it decides to. With Synthe, the agent holds no credential at all. It commits on its own branch and proposes the push. The Synthe broker runs as its own user and holds the only GitHub token. It shows you its own copy of the diff, waits for your passphrase-signed approval, and pushes exactly that commit. It records every decision, allowed or refused, in a hash-chained receipt log.

What's proven

Verified on 2026-10-07 on macOS, against real GitHub. The evidence is in docs/OPENCLAW_RESULTS.md.

  • ENFORCED: the broker runs as _synthe and the agent in its own account with no credentials. All 8 doctor checks pass.

  • A real OpenClaw agent (Claude Opus) followed the rules on its own: it proposed, then stopped for approval.

  • A live red team of 30 attacks (plus 3 controls for the approved path) from the agent's account: every attack was refused or contained (docs/REDTEAM.md):

    • forged, tampered and replayed tasks;
    • pushes outside the allowed files or branches, or to main;
    • history rewrites;
    • self-approvals;
    • swapping the commit while you read the diff.

    Every refusal the broker handled (13) left a signed receipt, and the chain verifies with the broker's published key. The other attacks failed before reaching it. Every row is in docs/results/redteam-2026-10-07.json.

Get started (macOS, OpenClaw)

QUICKSTART_OPENCLAW.md. Your coding agent can do the preparation (skills/synthe-setup/SKILL.md). You run one command, which asks for a passphrase, your GitHub token (hidden) and your Mac password.

Using Claude Code, Cursor, Cline, or no AI at all? See docs/ANY_AGENT.md.

What's here

Part Where License
The handoff contract: spec, schema, conformance vectors SPEC.md, schema/, examples/ Apache-2.0
Checker, signing, client, MCP server, setup and approval tools src/ (except the broker files) Apache-2.0
The OpenClaw plugin and skill; the setup skill integrations/openclaw/, skills/ Apache-2.0
The broker and its installers src/synthe_commit.py, synthe_broker.py, synthe_plan.py, deploy/ FSL-1.1-ALv2

See LICENSING.md. "Synthe" and the logo are trademarks of Synthe.

What Synthe doesn't claim

  • The OpenClaw plugin is a seatbelt. The wall is that the agent holds no credential.
  • Synthe mediates git effects. It doesn't stop prompt injection, and it doesn't judge whether approved code is correct.
  • What each part does and doesn't protect is in THREAT_MODEL.md.

About

Synthe: dependency-free checker that validates agent-to-agent handoff packets (artifact freshness by hash, required evidence, approvals, no duplicate execution) before the receiving agent starts. GitHub Action included.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages