Weave

Weave is a fork of the Codex CLI that adds native agent-to-agent coordination while preserving the familiar Codex workflow. It introduces persistent Weave sessions—shared chat rooms where multiple CLI agents can communicate, share context, and collaborate in real time.

With Weave, you can name agents, spin up unlimited concurrent sessions, and orchestrate relay-style workflows using simple prompts. This makes it easy to build advanced, multi-agent workflows without sacrificing the simplicity and ergonomics of the standard Codex CLI experience.

Quickstart (npm, macOS)

Install the Codex+Weave CLI:

npm install -g @rosem_soo/weave

Start the Weave coordinator:

weave-service start

Run the Codex+Weave CLI:

weave

Stop the Weave coordinator when finished:

weave-service stop

Restart the coordinator to pick up a new binary:

weave-service restart

Config (recommended)

To avoid confusion with collaborative features creating new agents, disable collab mode in ~/.codex/config.toml:

[features]
collab = false

Weave commands

/weave

Opens the Weave session menu. From there you can:

• Create a new session.
• Join/leave a session (the active one is marked with a check).
• Close an existing session.
• Set your agent name (shown to other agents).
• Set your lead role (only the lead can start relays and send control actions).

You need to join a session before agent mentions will work. Only the lead can start relays; non-lead mentions are treated as normal chat.

#agent

Use # mentions to relay tasks to other agents in the current session. Type # to open the agent picker, or type the agent ID/name directly:

#emma Please investigate the failing tests.
#review-a #review-b Review the PR and summarize changes.

#agent /command

After a mention, type / to open the agent command menu. Pick a command and send the message to execute it.

Commands: /new, /interrupt, /compact

Control commands apply to the agent's current Weave task (conversation owned by the sender). They do not interrupt a task the target started locally.

Examples:

#fred /new
#fred /interrupt
#fred /compact

Weave coordinator notes

• Default socket: ~/.weave/coord.sock
• Override with WEAVE_HOME=/path/to/dir