Catalog PyPI
PACKAGE EXPLORERView in registry

agent-cowork-memory

PyPI

Shared task memory and delegation for Codex, Cursor, Claude Code, and OpenCode.

Versions collected1
Direct dependencies1From release 0.2.4
Last observed20 Oct, 21:44 UTC

README

Version 0.2.4 documentation

Agent Cowork Memory (ACM)

Tired of copying a chat into the next agent? Pick up the same task where you left off, or tell one agent to put the others to work.

GitHub Release PyPI License Agents supported Python MCP supported CLI supported

Codex icon Codex  ·  Claude Code icon Claude Code  ·  Cursor icon Cursor  ·  OpenCode icon OpenCode

Install

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uvx agent-cowork-memory setup

or

pip install agent-cowork-memory
acm setup

Restart Codex, Cursor, and OpenCode. ACM is now available in every project. For Claude Code, add it yourself, then restart Claude Code:

claude mcp add -s user acm -- uvx agent-cowork-memory mcp --harness claude

Installed with pip, use -- acm mcp --harness claude instead.

Use

Memory Sharing

Open the same project in Codex and Cursor. To pick up a chat in the other agent, ask:

Use ACM to continue from Cursor.

Or, in Cursor:

Use ACM to continue from Codex.

Every agent can see every chat in the project. If there is more than one, the agent lists them (agent, time, task, first message, and whether ACM started it for a delegated job) and asks you which one to continue. You can also name it:

Use ACM to continue the Codex chat about the trip.

For ongoing work, ask your agent to use ACM to track the task or remember a decision. You can ask it to search those notes later.

Delegate to other agents

Any agent can hand work to the others:

Tell codex to write plan.md, and claude to write packing.md.

Each agent gets a brief, claims the files it edits so they don't collide, and reports back. Agents run in the background. With herdr installed, each one gets its own pane you can watch (herdr session attach acm).

Delegated agents run in each agent's auto mode: Codex --approve-for-me, Claude Code --permission-mode auto, and Cursor --auto-review. Safe actions run on their own. When auto mode denies an action, the agent stops, and ACM reports the job as needs_approval to the chat that delegated it, saying what the agent needs. A background job still running after 15 minutes is stopped and reported the same way. Approve it there, and that agent runs the step or delegates again. If an agent asks a question in its herdr pane instead, ACM reports the job as blocked until you answer it there. OpenCode has no auto-review mode, so it runs with --auto, which approves anything not explicitly denied.

There is one agent per kind per folder. A task for a busy agent comes back as busy.

MCP tools

ToolWhat it does
chatsLists recent chats from every agent in the project, and marks the ones ACM started.
resumeAsks you which chat to continue when there are several, then reads it and picks up the task.
attachStarts or joins a shared task.
contextReads your task, project notes, who is working, and which files are held. Passhold to claim files before writing.
note_addSaves a short-term or long-term note.
note_searchFinds notes from the project.
delegateStarts other agents with a brief, in herdr panes or in the background, and waits for them.
delegate_waitKeeps waiting on this chat's delegated agents.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.2.42 Oct 20261

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 21:44 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:e24d413781b01c4e45a9002ba71aae5d020a2c1c4b50452174b67028dc451c36