Reference · the tools · sessions

Start a Claude session on this box

What it does

Start a new Claude Code session on this box, through its Remote Control bridge -- the same kind of session the owner starts from the Claude app, in their session list, which they can open and drive. Not a subagent: it runs on its own and outlives the caller. The prompt is the only thing it knows, so make it a complete brief: the goal, the environment or repository, and what done looks like. Sessions start in the home directory; to work in an environment, say so and it will claim one. To hear back from it, put your own address in the prompt: `bridge:session_<id>`, your session id with cse_ changed to session_. Takes a few seconds; returns the link. On a box with more than one workspace, it starts in main unless workspace names another; it is then on that workspace's Claude account.

What it needs to know

title

What the session list will call it.

prompt

The first message: everything the session needs to start.

model · optional

A Claude model id, if not the account default.

permission_mode · optional

What it may do without asking. Default auto: it works on its own and asks only for risky actions, since nobody is watching it yet. manual asks before every command. One of auto, manual, acceptEdits, plan.

workspace · optional

The workspace to start it in, by name, on a box with more than one. Default main.

box · optional

Which box: its name and account, "home.frank" or "jordan.northwind", or just "home" when only one of your boxes is called that. Omit it for your current box (switch_box changes it; list_boxes says which it is).

session_box · optional

The box this session runs on, if it runs on one of yours: its name, as the on-box instructions give it ("frankh90.hemlane"). With it, a call that names no box is checked against your current box.

Where it lands

On one of your boxes: the one named in box, or your default box when none is named.