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
.claude/agents/task_start_screen.mdWhat 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_idfrom 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.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/task_start_screen.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/task_start_screen.mdCursor also reads .claude/agents/
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