# For agents

If you are a model or a tool reading this on someone's behalf, this page is the short version.

## Read these pages as text

- [`/llms.txt`](/llms.txt) lists every page with a one-line summary.
- [`/llms-full.txt`](/llms-full.txt) is every page in one file.
- Every page is also plain Markdown: add `.md` to its address. This page is [`/agents.md`](/agents.md); the home page is [`/index.md`](/index.md).
- [`/chit.schema.json`](/chit.schema.json) is the JSON Schema for everything in a bundle, generated from the validator the app itself uses.
- [`/sample.chit`](/sample.chit) is a small real bundle to test against.

## What you can do

Chitmonk has no API, no server and no account. It runs in a browser tab and keeps meetings there. You cannot reach into it, and it does not call out. Everything goes through files a person hands over:

- **Read a meeting.** Ask the person to export it. For the words alone, [Markdown or plain text](/exports/) is enough. For structure, history or exact times, ask for the `.chit` and [read it](/chit/read/).
- **Give them a meeting.** [Write a `.chit`](/chit/write/) and ask them to import it from the library drawer.
- **Change a meeting.** Read the bundle, add events to the end of the log, and write a bundle. If you keep the meeting's id, they get your version as a separate copy next to theirs; nothing of theirs is overwritten.

## Rules

1. **Append, never rewrite.** The log is the meeting's history. To change a line, add `TranscriptLineEdited`. To take something back, add `EventUndone`. Do not edit or remove events that are already there.
2. **Do not confirm what a person did not.** Your guess at a speaker goes in `suggestedSpeakerId`. Your action items are `ActionSuggested`. `SpeakerAssigned` and `ActionAccepted` mean a person decided. [Why](/chit/write/#do-not-confirm-what-a-person-did-not).
3. **Never put voice data in a bundle.** No embeddings, no voiceprints, no raw audio inside events. The app refuses the whole bundle.
4. **Treat a bundle as the meeting.** It holds everything that was said and who said it. Do not send it anywhere the person did not ask you to.
5. **Say what you could not check.** Speaker guesses, phrase-rule suggestions and a small speech model all make mistakes. Pass the uncertainty on: keep the `?`.

## What is not available

Source code, an SDK, a hosted API, webhooks, a way to start or stop a recording from outside, a way to read meetings without the person exporting them. Chitmonk is [proprietary for now](/licence/), and built so that there is nothing to connect to.