mirror of
https://github.com/stablyai/orca.git
synced 2026-11-16 19:07:41 +00:00
36 lines
2.5 KiB
TypeScript
36 lines
2.5 KiB
TypeScript
import type { CommandSpec } from '../discovery/command-spec'
|
|
import { CLI_GLOBAL_FLAGS as GLOBAL_FLAGS } from '../../shared/cli/cli-argument-boundary'
|
|
|
|
export const AGENT_LAUNCH_COMMAND_SPECS: CommandSpec[] = [
|
|
{
|
|
path: ['agent', 'launch'],
|
|
summary: 'Start an agent in an existing workspace, as a chat or a terminal',
|
|
usage:
|
|
'orca agent launch --agent <id> [--worktree <selector>] [--prompt <text>] [--model <id>] [--effort <level>] [--surface chat|terminal] [--focus] [--retry-launch <operationId>] [--json]',
|
|
allowedFlags: [
|
|
...GLOBAL_FLAGS,
|
|
'agent',
|
|
'worktree',
|
|
'prompt',
|
|
'model',
|
|
'effort',
|
|
'surface',
|
|
'focus',
|
|
'retry-launch'
|
|
],
|
|
notes: [
|
|
'Starts the agent the way a new agent tab does: as a chat when your Chat | CLI choice for the agent is Chat and the agent and host support it, otherwise as a terminal. The result says which (`outcome.kind`) and why (`receipt.detail`).',
|
|
'--surface chat|terminal picks for this launch instead of your setting. --surface terminal always runs the agent CLI; --surface chat is refused when Orca can establish before starting anything that this agent cannot open as a chat there. If support cannot be checked, the launch can fall back to a terminal. If chat becomes unavailable after creating a workspace, Orca keeps the workspace, setup and default tabs, then opens a terminal; the receipt explains the fallback.',
|
|
'--worktree defaults to the native folder workspace or worktree containing the current directory. For a new checkout with its agent, use `orca worktree create --agent`.',
|
|
'--model takes a provider model id (OMP also takes its model roles and selectors) and --effort a reasoning effort for that model; --effort requires --model. Pi takes a `provider/id` model and maps --effort to `--thinking` (off, minimal, low, medium, high, xhigh, max). They apply to either surface.',
|
|
'The tab opens without switching focus; pass --focus to switch to it.',
|
|
'If the launch reply is lost, re-issue the same command from the same directory on the same host with --retry-launch <operationId> from the error. Never retry as a fresh launch; older hosts require inspecting the workspace first.'
|
|
],
|
|
examples: [
|
|
'orca agent launch --agent codex --json',
|
|
'orca agent launch --agent codex --model gpt-6-astra --effort high --prompt "Write the design doc" --json',
|
|
'orca agent launch --agent claude --worktree path:/projects/myapp --focus'
|
|
]
|
|
}
|
|
]
|