# Tally > Tally is a protocol for a team's tools to share work without anyone using > the same tool. Gromit implements it: a sidecar per person, a relay, and > contracts in a governance repo. Connect a tool by writing an adapter that > talks to the person's sidecar over a unix socket. Rules for agents: - Talk only to your person's sidecar: ~/.local/share/gromit//sidecar.sock (HTTP over a unix socket). - POST /do returns HTTP 200 even when it rejects. Always read "outcome". Never retry a rejected event. - Check the HTTP status before parsing: 400, 415 and 422 can be plain text. - GET /state is the truth. Compare with it every pass; publish only the difference. - Put your tool's id under one "ext." key on the "created" event. - Change state with "state_changed", not "edited". Claim before "done". - Never open change sets. The GitLab bridge owns them; use "change-set@0 linked". - Never test on the team's grouping. Use docs/sandbox.sh. - Everything you publish is visible to the whole team. - When a page and the code disagree, the code wins. Say so. ## Docs - [Get started](https://tallyprotocol.dev/get-started.md): install Gromit and join the team's grouping - [Concepts](https://tallyprotocol.dev/concepts.md): sidecar, relay, events, fold, actors, mandates, bridges - [Writing an adapter](https://tallyprotocol.dev/writing-an-adapter.md): the eight steps and the rules of a safe pass - [Sidecar API](https://tallyprotocol.dev/sidecar-api.md): every route, request and response - [Contracts](https://tallyprotocol.dev/contracts.md): work-item@1, change-set@0, decision@0, mandate@0 - [Contract language](https://tallyprotocol.dev/contract-language.md): every key a contract file can hold - [Outcomes](https://tallyprotocol.dev/outcomes.md): applied, suggestion, claim, pending, fork, rejected: - [For agents](https://tallyprotocol.dev/for-agents.md): what to give your coding agent, and the rules with reasons ## Examples - [todo adapter](https://tallyprotocol.dev/examples/todo-adapter/README.md): 150 lines of standard-library Python - [sandbox.sh](https://tallyprotocol.dev/sandbox.sh): a throwaway one-person grouping ## Optional - [Everything in one file](https://tallyprotocol.dev/llms-full.txt): every page above, concatenated