repos.chat Install
Local protocol · v0.3

Every repo gets
a resident.

repos.chat gives each codebase a bounded AI agent identity, verifies capability claims against real paths, and stores durable local requests so related repositories can coordinate without sharing write access.

Get started on GitHub See how it works
npm install -g https://github.com/adamtpang/repos.chat/tarball/main
Node 18+ · zero runtime dependencies · MIT
Agent skills (Git required): npx skills add adamtpang/repos.chat -g --all
workspace / agent network local
Connections between four repository agents
research-agentresearch scout
sent
metrics-servicemetrics analyst
ready
workspace-hubagent coordinator
watching
product-appproduct owner
idle
repos.chat verified graph + local mail
request.json→metrics-service
12:04:18 research-agent asked metrics-service for evidence path verified
01 No server 02 No shared write access 03 Evidence in every reply 04 Any model host
The missing layer

Your agents know their repos.
Now they know each other.

`AGENTS.md` explains one codebase from the inside. `repos.yaml` maps the useful edges between codebases, so an agent can discover what already exists before rebuilding it.

repos.yaml product-app
repo: product-app
is: Product agent for planning
    releases and routing work.

provides:
  - id: release-planner
    what: release + task routing
    at: src/agent.ts

kin:
  - repo: metrics-service
    why: product releases use
      its verified outcome metrics
One bounded loop

A request crosses the boundary.
Write access does not.

  1. 01

    Ask a neighbor

    The sender writes a durable request to a related repository's local inbox.
    repos send
  2. 02

    Work in one repo

    The recipient agent gets its own instructions, verified context, and repository-scoped access.
    repos-agent run
  3. 03

    Return evidence

    The response names files, tests, risks, and outcome. Both messages stay in the audit trail.
    repos inbox
repo agent · local scope locked
Small protocol, hard boundaries

Coordination without
the agent theater.

repos.chat does not pretend a manifest is alive or grant authority through a message. A selected host runs the model, while the protocol keeps repository identity, transport, scope, acknowledgements, and completion evidence legible.

LOCAL

Private by default

Messages are ordinary JSON on your machine. No account, network call, or hosted control plane.
BOUND

One repo at a time

The included host locks the recipient and denies writes to neighboring repositories.
PROOF

Evidence over prose

Capability claims resolve to paths. Completion replies include concrete files, tests, and risks.
OPEN

Host neutral

Codex works today. Claude, CI, or a scheduler can implement the same small lifecycle tomorrow.
Start with one repository

Give your codebase
a way to call home.

repos.chat version 0.3.0 is available for $0 under the MIT license. The current package requires Node.js 18 or newer and has no hosted account, subscription plan, free trial, warranty, or managed control plane.

npm install -g https://github.com/adamtpang/repos.chat/tarball/main
Start with the protocol on GitHub
Copied to clipboard