Skip to main content

Command Reference

Use this page as the canonical command map for si.

Command discovery workflow

si --help
si <command> --help
si <command> <subcommand> --help

Core runtime commands

Command familyPrimary purposeMajor subcommandsDetailed guide
si dyadManage actor/critic pairsspawn, status, peek, exec, logs, cleanupDyad
codex lifecycle (si spawn, si run, etc.)Manage codex containers and one-off runsspawn, respawn, status, report, run, warmupCLI Reference
si vault (si creds)Encrypt and inject dotenv secretsinit, status, list, set, run, docker exec, trustVault
si browserDockerized Playwright MCP runtimebuild, start, status, logs, proxyBrowser
si pluginsPlugin registry and lifecyclelist, install, update, enable, doctor, scaffold, policyPlugin Marketplace

Provider and integration command families

IntegrationCommand familyTypical first checksDetailed guide
GitHubsi github ...si github auth status, si github doctorGitHub
Cloudflaresi cloudflare ...si cloudflare auth status, si cloudflare doctorCloudflare
GCP + Gemini/Vertexsi gcp ...si gcp auth status, si gcp doctorGCP
Google Placessi google places ...si google places auth status, si google places doctorGoogle Places
Google Playsi google play ...si google play auth status, si google play doctorGoogle Play
YouTube Datasi google youtube ...si google youtube auth status, si google youtube doctorGoogle YouTube
AWSsi aws ...si aws auth status, si aws doctorAWS
OpenAIsi openai ...si openai auth status, si openai doctorOpenAI
OCIsi oci ...si oci auth status, si oci doctorOCI
Stripesi stripe ...si stripe auth status, si stripe doctorStripe
Social APIssi social ...si social <platform> auth status, doctorSocial
WorkOSsi workos ...si workos auth status, si workos doctorWorkOS
Apple App Store Connectsi apple appstore ...si apple appstore auth status, doctorApple App Store
Publish flowssi publish ...si publish catalog listPublish
Provider telemetrysi providers ...si providers characteristics, si providers healthProviders

PaaS and operations commands

Command familyPurposeHigh-signal commandsGuide
si paasDeploy and operate apps on SI PaaSdoctor, deploy, logs, backup, eventsPaaS Overview
si paas appApp lifecycle controlslist, status, env, deployPaaS Context Operations
si paas backupBackup and restore workflowsrun, list, restorePaaS Backup Policy
si paas agentAutomation agent runtimelist, enable, run-once, logsPaaS Agent Runtime Commands

Build, docs, and developer tooling

Command familyPurposeTypical usage
si build imageBuild local runtime imagesi build image
si build selfBuild or upgrade si binarysi build self
si mintlifyDocs lifecycle commandssi mintlify validate, si mintlify dev
si analyze (si lint)Go static analysissi analyze --module tools/si
si dockerRaw Docker passthroughsi docker ps
si personaPersona/profile helperssi persona <name>
si skillSkill role helpersi skill <role>

1. New machine bootstrap

si build self
si vault status
si --help
si mintlify validate

2. Integration readiness check

si providers characteristics --json
si providers health --json
si github doctor --json
si cloudflare doctor --json

3. Pre-production PaaS check

si paas doctor --json
si paas backup run --app <slug> --json
si paas events tail --json

Guardrails

  • Prefer si vault run -- <cmd> for any command that needs secrets.
  • Run integration-specific doctor commands before write operations.
  • Run si mintlify validate for docs changes and si analyze for Go changes.