- An invitation. Mnemom durable agent and Mnemom contracted agents come with the Durable agent invite tier, enabled per Mnemom org by invitation. Accept your invitation with
mnemom agent --invite <token>. If you have none, ask your Mnemom contact, or ask for access at mnemom.ai/waitlist. - macOS. The host daemon runs on macOS only. On any other platform
mnemom agent host installfails withthe host daemon runs on macOS only.
Set up
mnemom agent setup durable walks three steps. Each is marked ✓ (done), ✗ (needs you) or · (still to do, or could not be checked). It picks up where it left off if you run it again. --dry-run shows the plan without changing anything, and --json prints it as JSON.
- Agent. You are signed in and your agent exists. If not, it runs the normal
mnemom agentsign-in. - Plan. Durable sessions are on for your Mnemom org. If they are off, it prints the invitation command above.
- Record. Turns durable sessions on for this machine. This is the same as
mnemom experimental enable durable.
setup durable does not install the host daemon. Run mnemom agent host install next. It reads the durable setting from ~/.mnemom/config.json only. Turning durable on for one shell with MNEMOM_EXPERIMENTAL is not enough for the daemon, and host install says so.
Name and lock a session
Start or continue a named session withmnemom agent <name>:
-, and cannot be a reserved verb: sessions, show, setup, doctor, config, list, claim, move, export, help, invite, lock, done, kill, pause, resume, amend, host or containment.
A session you start this way is tracked: it runs in your terminal and is recorded like any other session. To make it durable, lock it:
lock checks the following before it locks anything, and prints the fix for whichever check fails:
- The session runs in the root of a git repository, and Claude Code already trusts that directory.
- The session has had its first turn.
- This machine has an enrolled host daemon (
mnemom agent host install). - Your Mnemom account has MFA: a passkey or a TOTP factor.
- For a GitHub repository you can push to, the default branch has branch protection or an active ruleset. A ruleset in
evaluatemode does not count, and remotes other than github.com fail this check. - Durable sessions are enabled for your org.
lock hands it to the daemon rather than starting a second copy. When it succeeds it prints the session’s rules, budget and agent, and this note:
Here the session acts with your account’s access on this machine. Never-rules and holds are tripwires, not walls; a container is the recommended home for work on its own.Once an agent has a locked session, its plain keys stop working and it becomes durable-only. If the agent already has other live sessions, lock with
--own-agent to move the locked session to an agent of its own.
You can also have the launcher lock sessions for you. Set durable = ask in your launcher settings to be asked Make <name> durable? [y/N] on each launch, or durable = always to lock every launch. The default is off.
mnemom agent sessions adopt hands every running tracked session on this machine to the daemon at once. It shows one table and asks once per agent. --dry-run shows what it would do.
Talk to a locked session
A locked session has no terminal you can type into. Use these instead:sessions send queues a message. The daemon delivers it as the session’s next prompt once the session is idle. A message is 1 to 16,384 bytes, and an undelivered message expires after 7 days.
sessions questions lists the questions the session asked. When a locked session asks a question, Mnemom records it instead of showing a dialog nobody would see. --all also lists answered, dismissed and expired questions. A question expires 24 hours after it is asked.
sessions answer <name> <id|latest> <choice>... answers one question. Give one choice per question in the ask, in order. A choice is an option number (1, or 1,3 for a question that allows several), an option label, or free text. --dismiss dismisses the question instead. If the session is waiting, it takes the answer at once; otherwise the answer reaches it as its next message.
sessions senders list|add|remove <name> manages the other agents allowed to send to the session (up to 32).
Pause, resume, end and amend
- Only the person who started the session can run these. An org admin who is not the owner can stop the whole agent with
mnemom agent containment pause <agent>. pauseandresumeapply to locked sessions only.doneandkillalso work on a tracked session, and stop its local process.- A session that has ended cannot be changed.
- Repeating a verb that already applied prints
no change. amendtakes--budget <usd>and--turns <n>. Lowering a limit applies at once, and--turnscan only lower. Raising the budget needs your approval in the browser (a device step: the CLI prints a URL and a code), and the session must not be paused. There is no default budget; a budget applies only if you set one.sessions unlockalso needs a device step.
pause, resume, done, kill, amend, lock and the sessions message verbs take --json.
The host daemon
- The daemon is a user LaunchAgent (
~/Library/LaunchAgents/ai.mnemom.agent-host.default.plist). launchd restarts it if it exits. - It runs your locked sessions in its own tmux server and never touches your other tmux sessions.
- It needs
claudeon yourPATH, orMNEMOM_AGENT_CLIset to its absolute path. - It checks for work every 10 seconds and starts up to 4 sessions at once.
- A session that fails to start 3 times in a row is suspended;
mnemom agent resume <name>clears it. - A machine’s grant lasts 30 days. Renew it with
mnemom agent host renew. - The daemon logs to
~/.mnemom/durable/logs/daemon.log. - If durable sessions are turned off in
~/.mnemom/config.json, the daemon stays idle.
mnemom agent doctor adds durable checks when durable sessions are on: MFA, and branch protection for the repositories of up to five open sessions. It changes nothing.
Webhooks
A locked session’s turns run with nobody watching. When the gateway refuses or holds one of them for your review, Mnemom sends adurable.turn.refused or durable.turn.held webhook event. See Durable sessions events.