Skip to content
Download

Sessions working together

The tools every agent gets from Newen to start, read, message and wait for other sessions.

Newen gives every agent the same set of tools of its own, so one session can hand work to another, even one of a different agent: Claude Code can start a Codex session, and wait for it. The tools come in a server named sessions; agents see them as mcp__sessions__start_session and so on.

Tool What the agent can do
start_session Start a session for a separate task: its title, its prompt, the agent (another CLI if you like), and a fresh context or a fork of its own.
send_to_session Send a message to a session it started.
read_session Read another session of the project: its title, folder and conversation so far.
list_sessions List the project’s other sessions, whether each is working, idle or waiting, and the agents it can start.
wait_for_session End its turn and go on when the other session finishes, with a note of what to do then.
dismiss_task Withdraw a session it proposed and you have not started.
suggest_connectors Show you a card with a Connect button for each connector it needs, and wait until you connect them or close it.
  • When you asked for it, start_session starts the session at once. When the agent thinks of it on its own, it only proposes one: a card shows the task, and nothing runs until you start it.
  • A session started by another shows in the sidebar like any other, and the one that started it shows Waiting for «title» · Codex, with Cancel. View session opens it.
  • From the side pane you can Steer this session… of a session an agent started.
  • One session can wait for up to five others.

Every adapter offers all of these tools through its CLI’s own mechanism, and each has a test that every tool is offered:

  • Claude Code: an MCP server inside the adapter, loaded with the session.
  • Codex: Codex’s dynamic tools, given when the thread starts.
  • OpenCode and Hermes: an MCP server Newen adds to the session, newen --mcp-host sessions, which talks to Newen with a key of that session only.