si is an AI-first CLI for orchestrating coding agents, provider bridges, and secure runtime workflows.

Quick links: docs/index.mdx · docs/CLI_REFERENCE.md · docs/VAULT.md · docs/RELEASING.md

• Dyads: actor + critic paired containers, closed-loop execution, status/log/exec workflows.
• Codex containers: profile-scoped container lifecycle (spawn, status, run, report, clone, remove, warmup).
• Vault: encrypted dotenv workflows with trust/recipient checks and secure command injection.
• Provider bridges: Stripe, GitHub, Cloudflare, Google (Places/Play/YouTube), Apple, Social, WorkOS, AWS, GCP, OpenAI, OCI.
• Orbitals: namespaced integration catalog + install/enable/doctor lifecycle (si orbits ...).
• Browser runtime: Dockerized Playwright MCP runtime (si browser ...).
• Sustainable automation agents: PR guardian and website sentry (tools/agents/*).
• Docs workflow: Mintlify wrapper (si mintlify ...) to bootstrap and maintain docs locally.

• tools/si: main Go CLI.
• tools/si-browser: browser runtime Docker assets.
• tools/si-image: unified runtime image used by codex and dyad containers.
• docs/: Markdown + Mintlify docs content.
• agents/: dyad runtime components.

Use one of these install paths:

# npm (global launcher package)
npm install -g @aureuma/si

# Homebrew
brew install aureuma/si/si

Homebrew uses user/repo/formula for external taps, so brew install aureuma/si is not a valid formula path.

Direct installer script remains available:

curl -fsSL https://raw.githubusercontent.com/Aureuma/si/main/tools/install-si.sh | bash

Prerequisites:

• Docker Engine available on host.
• Go 1.25+ only if building si directly on host (otherwise use Dockerized build flows).

Build local CLI + runtime image:

# host build
cd /path/to/si
go build -o si ./tools/si

# runtime image for dyads/codex
./si build image

Dyad lifecycle:

./si dyad spawn <name> --profile <profile>
./si dyad status <name>
./si dyad logs <name>
./si dyad exec --member actor <name> -- bash
./si dyad remove <name>

Browser runtime:

./si browser build
./si browser start
./si browser status
./si browser logs --follow
./si browser stop

When running, SI-managed codex and dyad containers auto-register MCP server si_browser to the browser runtime endpoint on the shared Docker network.

Mintlify docs tooling:

./si mintlify init --repo . --docs-dir docs --site-url https://docs.si.aureuma.ai --force
./si mintlify validate
./si mintlify dev

• si dyad ... / codex lifecycle commands: agent runtime operations.
• si vault ...: secure secret workflows.
• si providers ...: provider characteristics + health surfaces.
• si orbits ...: Orbitals and integration onboarding.
• si browser ...: Playwright MCP browser runtime.
• si mintlify ...: docs site bootstrap/validation/dev wrappers.
• si build ...: local image + self-build workflows.

Full command surface: run si --help and command-specific help (si <command> --help).

Run module tests:

./tools/test.sh

Run installer smoke tests:

./tools/test-install-si.sh
./tools/test-install-si-docker.sh

Run strict vault-focused tests:

./tools/test-vault.sh

Run the full local test stack in one command:

./tools/test-all.sh

Run static analysis:

./si analyze
./si analyze --module tools/si

Release process and runbook:

• docs/RELEASING.md
• docs/RELEASE_RUNBOOK.md
• CHANGELOG.md

Published GitHub Releases automatically include multi-arch CLI archives for:

• Linux (amd64, arm64, armv7)
• macOS (amd64, arm64)

Local preflight command:

• si build self release-assets --version vX.Y.Z --out-dir .artifacts/release-preflight
• tools/release/npm/publish-npm-from-vault.sh -- --version vX.Y.Z (vault key: NPM_GAT_AUREUMA_VANGUARDA)

This repository is licensed under GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE.