mnemom. Mnemom checks the request, seals it as a contract and starts a job. An agent does the work and opens a PR. The Mnemom record check on that PR shows the sealed contract.
Contracted agents build on durable sessions. Mnemom durable agent and Mnemom contracted agents come with the Durable agent invite tier, enabled per Mnemom org by invitation. Ask for access at mnemom.ai/waitlist.
setup contracted checks this first. The server runner needs the experimental dispatch feature. It may change or be removed with no deprecation period.Set up a repo
--dry-run prints the first screen and changes nothing. --json prints the plan and outcome as JSON and never prompts.
With the default runner (your CI), the steps are:
- Durable. Checks that durable sessions are on for your org and turns the Mnemom record on.
- GitHub App. Checks that the Mnemom Record App is installed on the repo. If not, it prints the install link and waits.
--app <slug>names a different App. - Model key. Checks that the repo has an
ANTHROPIC_API_KEYsecret (by name only, never the value). If not, it takes the key from$ANTHROPIC_API_KEYor a hidden prompt. It also gives the same key to Mnemom for the intake check. - Turn on. Switches the repo on with Mnemom.
- Runner. Checks that GitHub Actions is on, then opens a PR that adds the runner workflow and merges it.
--branch <name>sets the PR branch (defaultmnemom/record-enable).
Start a job from an issue
Label an issuemnemom to start. Without the label, opening or editing an issue does nothing. Mnemom checks the request, seals it as a contract and starts a job. If the request is not clear enough, Mnemom sends it back with a comment, and you edit the issue to answer.
The job opens a PR against the default branch and keeps working on it as you review. The PR gets a Mnemom record check that shows the sealed contract.
Hand an issue to the contracted agent covers how to write an issue that seals the first time, the optional limits block, and what the agent does on its PR.
Runners
Every job runs on exactly one runner. The repo has a default, and a single job can use another.CI
The runner is a GitHub Actions workflow that setup adds to the repo. It runs only on the default branch, is started by Mnemom, and needs theANTHROPIC_API_KEY repo secret.
A job can run for up to 6 hours (timeout-minutes: 360). This is GitHub’s hard limit for a job. The key the job gets from Mnemom also lasts 6 hours.
The Actions minutes are your own.
Server
With--runner server, jobs wait for a runner on your own machine:
mnemom agent run --once runs a single job and exits.
- A server job waits for a runner with no timeout, and it does not fall back to another runner.
- The job’s transcript stays on your machine. The two newest are kept.
- Run setup with
--runner serveragain when you re-run it. Without the flag, setup sets the default runner back toci.
Run one job on a different runner
mnemom agent fuel seals a batch of contracts in one confirmation. --runner ci|server runs that batch’s jobs on the runner you name. Without it, they use the repo’s default.
What it costs
You pay Anthropic directly for the model. Your Anthropic key pays for the intake check and for the agent’s work. CI jobs also use your own GitHub Actions minutes. Contracted agents are not a plan tier.Turn a repo off
--off to turn the repo back on.