Skip to content

bare agent: start the session idle and wait for the first message#61

Merged
hbrooks merged 1 commit into
mainfrom
idle-start
Jul 17, 2026
Merged

bare agent: start the session idle and wait for the first message#61
hbrooks merged 1 commit into
mainfrom
idle-start

Conversation

@hbrooks

@hbrooks hbrooks commented Jul 17, 2026

Copy link
Copy Markdown
Member

What

A promptless --connect start (what a bare agent expands to) now sends idle_start: true on POST /v1/sessions. The sandbox spins up, Claude Code starts idle at the prompt, and the first thing typed into the composer opens turn 0 - the same feel as launching a local claude. Typing while the sandbox provisions already works: the message queues in the session inbox and delivers as the initial content.

Why

Previously the server fabricated a workflow kickoff ("Carry out the workflow instructions in your system prompt." plus customer context and time) whenever the resolved config carried a claude.system, so a bare agent on a dev-box config opened with a pointer at workflow instructions that did not exist.

Notes

  • A promptless --watch/--detach start still runs the config's workflow kickoff; only the interactive open changes.
  • Servers without the field ignore it (pydantic drops unknown fields), so this degrades to today's behavior until the server side deploys.
  • Server side: ellipsis-dev/ellipsis#5899.

Testing

tsc --noEmit clean, vitest 236 passed. The change itself is a one-line conditional in the start action plus the request type.

A promptless connect start (what a bare `agent` expands to) now sends
idle_start on POST /v1/sessions: the sandbox spins up, Claude Code sits
idle at the prompt, and the first thing typed into the composer opens
turn 0, like a local `claude`. Previously the server fabricated a
workflow kickoff whenever the resolved config carried a claude.system,
so a bare `agent` on a dev-box config opened with "Carry out the
workflow instructions in your system prompt." and no instructions to
carry out.

A promptless --watch/--detach start still runs the config's workflow;
only the interactive open changes. Servers without the field ignore it
and keep today's behavior.
@hbrooks
hbrooks merged commit b38d36f into main Jul 17, 2026
1 check passed
@hbrooks
hbrooks deleted the idle-start branch July 17, 2026 22:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant