Skip to main content
subagent CX Codex

task_start_screen — Claude Code subagent

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.

MIT ★ 395 updated 2026-11-16

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

What task_start_screen does

The subagent reads the last 30 lines of a terminal tab that the task’s computer still holds open, even though the agent did not start there. Its output shows either a question waiting in the shell or where the agent’s screen stopped.

It only checks a task from the current conversation whose startup is being fixed. The lookup uses the task’s todo_id from its message; an optional reason is saved in the task history. The result remains in the conversation rather than being stored with the task.

For Claude Code, add the subagent file at .claude/agents/task_start_screen.md. Codex and Cursor use their own file paths.

What it helps with

  • find the shell prompt blocking a task
  • see where the agent’s screen stopped
  • inspect a task’s terminal tab after its agent failed to start

Example prompts for the agent

  • Check where the task with todo_id from the message stopped.
  • Read the last lines of the tab for task todo_id; its agent did not start.
  • Find out whether the shell is waiting for an answer for task todo_id.

How to install task_start_screen

Manually: put the files in place

.claude/agents/task_start_screen.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 task_start_screen

How do I install task_start_screen in Claude Code?

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

What does task_start_screen do?

It reads the last 30 lines of a task’s terminal tab when its agent did not start there. The output reveals a shell prompt or the point where the agent’s screen stopped.

Which tasks can task_start_screen inspect?

It checks only a task from the current conversation whose startup is being remedied. The task’s todo_id from its message is required.

Source text

task_start_screen.md · MIT
Read the last 30 lines of the terminal tab a task's agent did not start in, while its computer keeps that tab (a 督办 message says until when): the question the tab's shell waits on, or where the agent's own screen stopped. Only for a task of this conversation whose start is being remedied; what it shows stays here, it is not kept with the task.

```json
{
  "type": "object",
  "required": ["todo_id"],
  "properties": {
    "todo_id": {
      "type": "string",
      "description": "the task's id, as the 督办 message gives it"
    },
    "reason": {
      "type": "string",
      "description": "why you look, in the user's language (optional; kept with the task's history)"
    }
  }
}
```

© nwverse · MIT · nwverse/persona

Similar subagents

Subagents catalog →

From the same set61

The whole set →
instructions The instructions prompt for Claude Code and ChatGPT sets rules for Persona’s voice assistant. It routes requests to the right conversation and guides when to answer, search, or hand off work. GP ChatGPT ★ 395repo stars supervision_instructions supervision_instructions is a Claude Code prompt for supervising agent tasks and checking their results. It defines how to track assignments, respond to status signals, and decide whether work is ready to accept. GP ChatGPT ★ 395repo stars task_continuation The task_continuation subagent for Claude Code resumes work on an existing to-do. It keeps the original brief, decisions, and history on that task instead of opening a separate follow-up. CX Codex ★ 395repo stars 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 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 agent_read 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. 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

Project sponsors

Companies that keep this analytics open