didericis/bot-bottle
1
0
Fork 0
Code Issues 7 Pull Requests 5 Actions Packages Projects Releases Wiki Activity

Headless / non-interactive launch mode for orchestrators #315

New Issue
Open
opened 2026-06-29 11:43:02 -04:00 by didericis-claude · 0 comments
didericis-claude commented 2026-06-29 11:43:02 -04:00
Collaborator
Copy Link
Copy Source

Problem

cli.py start is interactive-only. It drives TUI selectors (agent pick, bottle multiselect, name/color modal) and a y/N preflight, then attaches a blocking PTY to the controlling terminal. That shape cannot be driven by an orchestrator (e.g. Paseo), CI, or webhook/comment dispatch, and it makes spinning up a known agent+bottle more friction than necessary.

Proposal

A --headless mode on start that takes agent / bottles / label / color from flags + manifest defaults, skips every prompt, and still execs the agent on the inherited stdio/PTY so an external PTY owner drives the session.

./cli.py start <agent> --headless [--bottle NAME ...] [--label L] [--color C]
  • --bottle (repeatable) defaults to the agent's own bottle: when omitted
  • --label defaults to the agent name; slug collisions auto-uniquify
  • --color defaults to none
  • preflight auto-confirmed (no human at the prompt)
  • --headless --dry-run previews the resolved plan without launching

Only the launch chrome goes non-interactive — the agent itself still runs as an interactive session on whatever PTY the caller provides.

Why

Prerequisite for orchestrator integration (Paseo), webhook/comment-driven dispatch, and remote spin-up — and a direct fix for the spin-up ergonomics.

## Problem `cli.py start` is interactive-only. It drives TUI selectors (agent pick, bottle multiselect, name/color modal) and a y/N preflight, then attaches a blocking PTY to the controlling terminal. That shape cannot be driven by an orchestrator (e.g. Paseo), CI, or webhook/comment dispatch, and it makes spinning up a known agent+bottle more friction than necessary. ## Proposal A `--headless` mode on `start` that takes agent / bottles / label / color from flags + manifest defaults, skips every prompt, and still execs the agent on the inherited stdio/PTY so an external PTY owner drives the session. ``` ./cli.py start <agent> --headless [--bottle NAME ...] [--label L] [--color C] ``` - `--bottle` (repeatable) defaults to the agent's own `bottle:` when omitted - `--label` defaults to the agent name; slug collisions auto-uniquify - `--color` defaults to none - preflight auto-confirmed (no human at the prompt) - `--headless --dry-run` previews the resolved plan without launching Only the launch *chrome* goes non-interactive — the agent itself still runs as an interactive session on whatever PTY the caller provides. ## Why Prerequisite for orchestrator integration (Paseo), webhook/comment-driven dispatch, and remote spin-up — and a direct fix for the spin-up ergonomics.
didericis added the Kind/Feature label 2026-06-29 11:45:20 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Compat/Breaking
Breaking change that won't be backward compatible
 Kind/Bug
Something is not working
 Kind/Documentation
Documentation changes
 Kind/Enhancement
Improve existing functionality
 Kind/Feature
New functionality
 Kind/Security
This is security issue
 Kind/Testing
Issue or pull request related to testing
Priority
Critical
1
The priority is critical
Priority
High
2
The priority is high
Priority
Low
4
The priority is low
Priority
Medium
3
The priority is medium
Reviewed
Confirmed
1
Issue has been confirmed
Reviewed
Duplicate
2
This issue or pull request already exists
Reviewed
Invalid
3
Invalid issue
Reviewed
Won't Fix
3
This issue won't be fixed
Status
Abandoned
3
Somebody has started to work on this but abandoned work
Status
Blocked
1
Something is blocking this issue or pull request
Status
Need More Info
2
Feedback is required to reproduce issue or to continue work
No Label Kind/Feature
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
didericis-claude (didericis (claude)) didericis-codex (didericis (codex)) didericis-gemma (gemma) didericis
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: didericis/bot-bottle#315
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?