Skip to main content
subagent CX Codex

agent_read — Claude Code subagent: features and install

This Claude Code subagent reads a selected agent’s recent conversation. It answers follow-up questions about completed work, conclusions, or why the agent stopped.

MIT ★ 395 updated 2026-11-16

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/agent_read.md
Open on GitHub

What agent_read does

agent_read returns recent user messages, the agent’s replies, and brief records of its tool calls. This lets another agent answer questions about work already done without using agent_send to start another turn.

A request needs machine and session_id, either the full session ID or its first 8 characters. Set turns to choose how many recent exchanges to read; it defaults to 2 and has a maximum of 10. A stopped agent accepts no messages, so its conversation is read-only.

For Claude Code, install the subagent file at .claude/agents/agent_read.md.

What it helps with

  • retrieve an agent’s conclusion from its recent conversation
  • find a PR link in an agent’s history
  • learn why an agent stopped
  • check which tools an agent called

Example prompts for the agent

  • Read the recent conversation for session abc12345 on machine and tell me why the agent stopped.
  • Check the last 4 exchanges for session abc12345 and find the PR link.
  • Read the agent’s history for session abc12345 and report its conclusion.

How to install agent_read

Manually: put the files in place

.claude/agents/agent_read.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about agent_read

How do I install agent_read in Claude Code?

Add the subagent file at .claude/agents/agent_read.md.

What does agent_read do?

It reads a selected agent’s recent conversation, including user messages, agent replies, and short records of tool calls. Another agent can use that history to answer follow-up questions without starting a new turn.

What information does agent_read need?

It needs machine and session_id. The session ID can be full or its first 8 characters; turns controls the number of recent exchanges, with a default of 2 and a maximum of 10.

Source text

agent_read.md · MIT
Read the recent conversation of one agent (from agents_list): the user's messages, what the agent said, tool calls in short form. `turns` = how many recent exchanges (default 2, max 10). Use it to answer the user's follow-ups about work an agent or task already did (its conclusion, a PR link, why it stopped) instead of asking the agent with agent_send, which makes it take another turn while the user waits (and a stopped agent takes no messages: it is read-only).

```json
{
  "type": "object",
  "required": ["machine", "session_id"],
  "properties": {
    "machine": {
      "type": "string"
    },
    "session_id": {
      "type": "string",
      "description": "full id or its first 8 characters"
    },
    "turns": {
      "type": "integer"
    }
  }
}
```

© nwverse · MIT · nwverse/persona

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set61

The whole set →
agent_unarchive The agent_unarchive Claude Code subagent returns an archived coding-agent session to the Agents list. It also asks the agent’s own tool to restore the session where it was archived. CX Codex ★ 395repo stars task_start_screen The task_start_screen Claude Code subagent reads the last lines of a task’s terminal tab when its agent failed to start. It shows a shell prompt waiting for input or the point where the agent’s screen stopped. CX Codex ★ 395repo stars dispatch_task The dispatch_task Claude Code subagent takes work from another coding agent and handles it itself. It pauses for approval before actions that affect others or external systems. CX Codex ★ 395repo stars task_retry The task_retry subagent for Claude Code restarts a task's agent after a failed launch. It reuses the existing tab when possible, or opens a new one. CX Codex ★ 395repo stars session_name The session_name Claude Code subagent names a session after the task being discussed. It uses the opening message and recent dialogue to reflect a change in direction. CX Codex ★ 395repo stars task_worker The task_worker Claude Code subagent handles an assigned part of a larger task. It can use in-session subagents but cannot pass work to other Persona tasks. CX Codex ★ 395repo stars codex_continuation The codex_continuation Claude Code subagent picks up a task from a separate Codex conversation in a fresh session. It uses recent messages to recover decisions, constraints, and unfinished work. CX Codex ★ 395repo stars question_released The question_released Claude Code subagent ends the current turn when another message arrives while a question awaits the user’s answer. The question card stays unchanged, and the answer returns in a later message. CX Codex ★ 395repo stars

Project sponsors

Companies that keep this analytics open