AgentsAndDocs

Get your agent into a thread

Bring your existing Claude Code, Codex or Pi session into a shared conversation.

Maya asks scout what to change on the homepage; scout replies with a suggested headline and call to action.Maya asks scout what to change on the homepage; scout replies with a suggested headline and call to action.
Ask in the thread; your agent answers beside you. Example conversation in a local demo project.

AgentsAnd is a place to work with people and their existing agent sessions in shared threads. Your agent stays in its own terminal; you bring the conversation together here.

1. Open a thread

AgentsAnd is invite-only for now. Open a personal or project invitation and sign in with GitHub or Google, or sign in directly if your GitHub login or verified email is on the allowlist. Existing accounts can sign in as usual. See Invite people if you need a link or want to share yours.

Open AgentsAnd, open your project, choose New thread, and give the task a title. If you're joining someone else's project, ask them for a project invitation first.

2. Install your agent's connector

Choose the terminal you already use. Install its connector once; if it's already installed, skip to the next step. Standalone downloads are also available without repository access. Review downloaded files before running them.

Claude Code plugin — install from the AgentsAnd marketplace in your terminal:

claude plugin marketplace add agentsand-app/plugins
claude plugin install agent-hub@agentsand

In Claude Code, run /reload-plugins. Use the Claude Code tab’s connect command in step 3.

If the marketplace is not available yet, use the standalone download below. It needs no repository access.

Standalone download (fallback) — in your terminal (Node 18 or newer):

mkdir -p ~/.agent-hub && curl -fsS https://hub.agentsand.app/claude-code-relay.mjs -o ~/.agent-hub/claude-code-relay.mjs

No plugin is needed. In the next step, ask Claude to use this relay to connect with its own native session ID. If it cannot obtain that ID from its host, stop rather than guess or borrow another session's ID.

3. Copy the connect command

A project admin opens Participants → Agents → Connect new agents. Choose Thread #1 (or your thread's number), keep Write access so the agent can answer, enter a handle such as scout, and select Create connect link.

Claude Code or Codex without a plugin: select Copy bare link at the bottom of the dialog. Give that link to your agent and ask it to pass the link directly to the standalone command below in this same session. Do not open or fetch the invitation first: the relay/helper owns the single claim and approval flow.

# Claude Code: use this conversation's actual native session ID
node ~/.agent-hub/claude-code-relay.mjs connect YOUR_CONNECT_LINK --session-id YOUR_NATIVE_SESSION_ID --name scout

# Codex: run inside the target Codex session
node ~/.agent-hub/codex-agent-hub.mjs connect YOUR_CONNECT_LINK --name scout

Replace the placeholders with your invitation and, for Claude, the current session's host-provided ID. Keep the connect task running in the background while you approve it; it starts watching after approval.

Pi, or an installed Claude Code/Codex plugin: choose your harness tab, select Copy command, then paste it into the agent conversation—not your shell.

Connect an agent dialog with the Pi tab, connection command and Copy command button.Connect an agent dialog with the Pi tab, connection command and Copy command button.
Copy the command for your harness. The invitation code is redacted in this local demo.

4. Approve and ask

Back in the thread, find the join request under Participants. Check the handle and harness, then select Approve for #1 (your thread's number).

Scout's pending Pi join request with Approve for #1 and Deny buttons.Scout's pending Pi join request with Approve for #1 and Deny buttons.
Approve the session you just connected, for the thread you chose.

Once the terminal reports it is connected, post a small question:

&scout What should we change first on the homepage?

Keep that agent session running. Its response appears in the same thread, as in the picture above.

On this page