Skill

tail-session

Use when you need to read new messages from a relay session.

npx claudepluginhub danielrosehill/claude-code-plugins --plugin agent-relay

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Stream new messages from a session, starting from the last known cursor.

SKILL.md

Similar Skills

cache-components

139.3k

Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

Stats

Stars0

Forks0

Last CommitMay 3, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Tail Session

Stream new messages from a session, starting from the last known cursor.

When to use

Polling for updates from other agents in a session

Checking for new files or coordination messages

Continuous monitoring with --follow option

Inputs to gather

Session name or ID

Optional --follow flag (loop continuously, checking for new messages every 2–5 seconds)

Procedure

Prompt for session identifier and optional --follow flag.

Load the last known cursor from ${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/agent-relay/cursors/<session>.txt (default to 0 if file doesn't exist).

Call read_inbox with the session_id and since_cursor parameter.

Parse the TOON response to extract messages, attachments, and metadata.

Render each message in human-readable form (sender, timestamp, body, attachments list).

Update the cursor file with the latest cursor from the response.

If --follow is set, loop back to step 3 after a short sleep (2–5 seconds); otherwise exit.

Output / side effects

Messages printed to stdout in a readable format.

Cursor file updated under $CLAUDE_USER_DATA/agent-relay/cursors/.

Blobs listed by sha256 and filename; user can fetch via download_blob if needed.

Continuous tail mode exits on Ctrl+C.

Safety / constraints

Cursor tracking is per-session, per-client; each instance maintains independent state.

TOON parsing should handle empty or malformed responses gracefully.

Long-running --follow processes should log or summarize activity periodically.

Tail Session

Stream new messages from a session, starting from the last known cursor.

When to use

Polling for updates from other agents in a session
Checking for new files or coordination messages
Continuous monitoring with --follow option

Inputs to gather

Session name or ID
Optional --follow flag (loop continuously, checking for new messages every 2–5 seconds)

Procedure

Prompt for session identifier and optional --follow flag.
Load the last known cursor from ${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/agent-relay/cursors/<session>.txt (default to 0 if file doesn't exist).
Call read_inbox with the session_id and since_cursor parameter.
Parse the TOON response to extract messages, attachments, and metadata.
Render each message in human-readable form (sender, timestamp, body, attachments list).
Update the cursor file with the latest cursor from the response.
If --follow is set, loop back to step 3 after a short sleep (2–5 seconds); otherwise exit.

Output / side effects

Messages printed to stdout in a readable format.
Cursor file updated under $CLAUDE_USER_DATA/agent-relay/cursors/.
Blobs listed by sha256 and filename; user can fetch via download_blob if needed.
Continuous tail mode exits on Ctrl+C.

Safety / constraints

Cursor tracking is per-session, per-client; each instance maintains independent state.
TOON parsing should handle empty or malformed responses gracefully.
Long-running --follow processes should log or summarize activity periodically.