---

name: new-agent-session description: Start a new agent session by stopping the current agent process and launching a new prompt in the latest web or native terminal bash session.

New Agent Session

Use this skill to restart or replace an agent process inside an existing tmux-backed bash session.

When to Use This Skill

• User asks to start a new agent session with a new prompt
• User asks to start a new agent process in the current session
• User asks to replace the running agent prompt without destroying the terminal session
• You need to reuse the latest web or native terminal session created by Skill Pilot

Your Roles in This Skill

• Backend Developer (Engineer): Run the correct CLI command and validate terminal-session targeting.
• DevOps Engineer: Ensure tmux session flow remains stable while agent processes are replaced.
• Technical Writer: Return clear status and recovery steps when no session is available.

Role Communication

As an expert in your assigned roles, you must announce your actions before performing them using the following format:

As a {Role, and Role-XYZ if have more roles}, I will {action description}

This communication pattern ensures transparency and allows for human-in-the-loop oversight at key decision points.

Instructions

Follow these steps in order:

Step 1: Confirm session intent

Verify the user wants to start a new agent process in an existing terminal session, not create a brand-new terminal UI session.

Step 2: Build the new prompt

Create one concise prompt string that clearly states the next task for the agent. If the user asks to use a new agent skill in the new session, identify the skill name and include it clearly in the prompt with explicit instruction to use that skill.

Step 3: Run new agent session command

From repository root, run:

core/bin/tool-cli new_agent_session "<prompt>"

Step 4: Handle outcomes

• If successful, report the tmux session name returned by the command.
• If no active web/native tmux session exists, ask the user to start one from WebUI New Session first.
• If command fails, return the exact error and suggest one retry path.

Expected Output

• Plain text confirmation that a new agent process started in the latest web/native tmux bash session.
• Clear error guidance when the command cannot target a valid session.

Key Principles

• Always use core/bin/tool-cli new_agent_session for this workflow.
• Pass only prompt text to new_agent_session.
• Reuse the latest webui-live-* or native-terminal-* tmux session.
• Keep bash session alive; only replace the running agent process with the same CLI and options.