53 lines
4.2 KiB
Go
53 lines
4.2 KiB
Go
package cli
|
|
|
|
// Help is also the public command inventory for agents and parity checks.
|
|
var usage = map[string]string{
|
|
"new": "new [name] [prompt] [--template KEY] [--no-open | --json]",
|
|
"edit": "edit [name|id] [prompt] [--version N] [--no-open | --json]",
|
|
"drafts": "drafts [--json]",
|
|
"draft-delete": "draft-delete <draft.md> [--json]",
|
|
"validate": "validate <draft.md> [--json]",
|
|
"submit": "submit <draft.md> [--name NAME] [--create-only] [--yes] [--json]",
|
|
"list": "list [--json]",
|
|
"show": "show <name|id> [--version N] [--json]",
|
|
"versions": "versions <name|id> [--json]",
|
|
"export": "export <name|id> [--version N]",
|
|
"templates": "templates [--json]",
|
|
"template": "template <key> [--source | --json]",
|
|
"run": "run [name|id] [prompt] [--json [--wait]]",
|
|
"runs": "runs [--pipeline NAME] [--json]",
|
|
"inspect": "inspect <run-id> [--json]",
|
|
"cancel": "cancel <run-id> [--json]",
|
|
"retry": "retry <run-id> [--json] [--wait]",
|
|
"debug": "debug <run-id> [--json | --no-open]",
|
|
"connection": "connection [--json]",
|
|
"ping": "ping [--json]",
|
|
"status": "status [--json]",
|
|
"stats": "stats [--json]",
|
|
"rpc": "rpc <request.json|->",
|
|
"tui": "tui",
|
|
}
|
|
|
|
var notes = map[string]string{
|
|
"new": "Create an optional template copy or a one-stage starter. Opens OpenCode with @pipelines; the skill asks any missing questions, including the name. No submission is performed.",
|
|
"edit": "Omit the name to open fuzzy selection. Original immutable source is copied to a private draft. OpenCode edits that draft, never the live definition.",
|
|
"validate": "Uses the same server parser as submission. Does not persist or activate schedules. Structural validity does not prove runtime/tool availability.",
|
|
"submit": "Confirm publication at the prompt, or use --yes for explicit automation; schedules activate on acceptance. Managed drafts provide the name and base-version guard. --force never bypasses validation.",
|
|
"run": "Runs in your current directory after action confirmation (--yes skips it). Select a pipeline and compose a multiline task with Ctrl+S. Stage tools are enabled automatically; no file list or typed RUN confirmation. Cancellation does not undo edits.",
|
|
"retry": "Start a new attempt of a failed run with the same initial input, directory, pipeline version, and edit scope. Original history is retained. Already-completed side effects are not undone.",
|
|
"debug": "Open a fresh OpenCode conversation to investigate a run using inspect/show/runs CLI queries. Does not resume the implementing session or retry the run. --json returns the investigation prompt without opening OpenCode.",
|
|
"rpc": "Accepts a JSON protocol envelope; '-' reads stdin. Every TUI server operation is available here too. Mutating commands are not dry runs.",
|
|
}
|
|
|
|
var serviceHelp = map[string]string{
|
|
"skill": "pipelines skill install installs/updates the bundled global OpenCode skill without changing login/config or user-modified skills. install.sh includes this step.",
|
|
"service": "Configure per-user OS autostart: pipelines service enable. Runs use the directory you invoke pipelines run from. Use --print to preview, service status to inspect, and service disable before uninstalling. Linux uses systemd; macOS uses launchd. No sudo.",
|
|
"serve": "Run the native server in the foreground. Its flags are documented by pipelines serve --help. Installation never starts it automatically.",
|
|
"start": "Start the per-user native pipeline server and this installation's Docker ntfy together.",
|
|
"stop": "Stop both services. Active execution is interrupted; file changes are not rolled back.",
|
|
"restart": "Stop, then start both services, retaining definitions, run history, and credentials.",
|
|
"doctor": "Check both health endpoints and host OpenCode API discovery; does not execute a model.",
|
|
"logs": "Follow the native server log. Press Ctrl+C to stop following.",
|
|
"uninstall": "Remove verified Go binaries from this command's bin directory; retain data and drafts. --yes skips confirmation. Existing managed installations can be selected explicitly with PIPELINES_PREFIX.",
|
|
}
|