Skip to content

docs: catch sem-ai CLI reference up with current release#1120

Open
skipi wants to merge 1 commit into
mainfrom
mk/sem-ai-cli-docs
Open

docs: catch sem-ai CLI reference up with current release#1120
skipi wants to merge 1 commit into
mainfrom
mk/sem-ai-cli-docs

Conversation

@skipi

@skipi skipi commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator

The sem-ai CLI reference had drifted behind the released CLI. This adds the missing pieces, verified against the current semaphoreio/sem-ai main (--help output and source):

  • sem-ai signin — browser device-flow auth (aliases signup/login), now the first thing in Setup. Includes the caveat that approving a sign-in resets an existing account token, and points at sem-ai connect for existing-token auth.
  • sem-ai context switch — was missing from the context section.
  • Environment variablesSEMAPHORE_HOST / SEMAPHORE_API_TOKEN override ~/.sem.yaml (useful for CI/containers).
  • Task parameterstask create --param-def NAME[=DEFAULT] and task run --param KEY=VALUE, plus the per-run --branch/--pipeline-file overrides.
  • sem-ai deploy update — PATCH semantics, with examples.
  • Claude Desktop MCPB bundles — one-click .mcpb extension attached to each sem-ai release, as an alternative to the CLI install.

Deliberately not documented: sem-ai notification create — it currently exits with not_implemented, so listing it would mislead.

🤖 Generated with Claude Code

Documents commands shipped since the page was last touched: signin
(browser device-flow auth, with the token-reset caveat), context
switch, SEMAPHORE_HOST/SEMAPHORE_API_TOKEN env overrides, task
parameters (create --param-def, run --param/--branch/--pipeline-file),
deploy update, and the Claude Desktop MCPB bundles attached to
releases.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

1 participant