Skip to content

feat(session): default config, inline overrides, consistent lingo (v0.8.0)#39

Merged
hbrooks merged 1 commit into
mainfrom
feat/session-defaults-and-lingo
Jul 12, 2026
Merged

feat(session): default config, inline overrides, consistent lingo (v0.8.0)#39
hbrooks merged 1 commit into
mainfrom
feat/session-defaults-and-lingo

Conversation

@hbrooks

@hbrooks hbrooks commented Jul 12, 2026

Copy link
Copy Markdown
Member

What

Makes agent session start usable with zero config, adds inline overrides, and cleans up inconsistent flag/term naming across the session command group.

session start

  • Config source is optional. With none of --config / --config-file / --template, the server runs the platform default config and the prompt is the sole instruction. (Requires the backend change that relaxes POST /v1/sessions.)
  • Positional prompt. agent session start "triage the failing CI" == -p "...". Passing both errors.
  • Sugar flags for the live config fields, each merged into one structured config_override (deep-merged under the raw --config-override, flags win): --model, --system, --repo (repeatable, owner/name or bare name), --cpu, --memory, --timeout, --budget.

Attach modes (collapsed)

  • -d, --detach (default) fire-and-forget; -w, --watch blocks until terminal streaming live; --watch --quiet blocks without streaming and exits with a code matching the outcome; --connect interactive. --wait retired in favor of --watch --quiet. --quiet also added to get/replay.

session connect

  • --no-input — follow read-only (never open the composer), for non-interactive callers.
  • --no-backlog renamed to --no-steps.

Naming consistency

  • --config <id> is the saved-config id on start / list / replay / search (was a mix of --config / --config-id / --agent).
  • "transcript" now means only the raw .jsonl artifact (the transcript command); rendered activity is "steps" everywhere; free-text is "prompt".

Version

Bumps package.json to 0.8.0 (minor: new features + breaking flag renames). The release tag v0.8.0 cuts the actual release on merge.

Tests / checks

bun run typecheck, bun run test (197 pass, incl. new buildStartOverride + watchSession exit-code coverage), and bun run build all green locally.

Ordering

The backend companion PR (relaxing POST /v1/sessions + pinning ELLIPSIS_CLI_VERSION = 0.8.0) should merge/deploy after v0.8.0 is released, since the sandbox image downloads that tag.

🤖 Generated with Claude Code

start: config source is now optional (server runs the default config); the prompt can be positional; add --model/--system/--repo/--cpu/--memory/--timeout/--budget sugar flags merged into one config override.

attach modes: --detach (default), --watch (live), --watch --quiet (block, exit code = outcome), --connect. Retire --wait.

connect: add --no-input (read-only, for non-interactive callers); rename --no-backlog to --no-steps.

lingo: --config is the saved-config id everywhere (was --config-id / --agent); reserve 'transcript' for the raw JSONL and 'steps' for rendered activity; 'prompt' for free-text. Bump version to 0.8.0.
@hbrooks hbrooks merged commit e16dc49 into main Jul 12, 2026
1 check passed
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