DistributionOS CLI

Installer for connecting an app repo to DistributionOS.

npx @distributionos/cli setup --app <appId>

Default setup opens the DistributionOS MCP OAuth approval flow when needed, then prints a setup review first. In an interactive terminal, approve the plan to apply the managed setup changes. In non-interactive agent runs, use --apply only after reviewing the setup output.

Agents that support installable skills can also load the public DistributionOS agent skill before using the CLI:

https://github.com/lawfan1026/distributionos-agent-skill

The CLI remains the default setup path. The skill is a public agent-readable guide for when to use the CLI, MCP, API fallback, analytics install, verification, and implementation reporting.

Commands

distributionos setup --app <appId>
distributionos setup --app <appId> --apply
distributionos login --app <appId>
distributionos verify --app <appId> --url <liveUrl> [--content-id <id>]
distributionos report-implementation --app <appId> --artifact <artifactId> [--url <liveUrl>]

Safety

• Uses DistributionOS MCP OAuth as the happy path.
• Stores OAuth credentials outside the app repo.
• Accepts API-key environment variables only as an advanced fallback.
• Does not write secrets into committed files.
• Scans repo structure without reading .env or credential-looking files.
• Redacts secret-looking validation output before printing or serializing results.
• Mutates only the managed DistributionOS bootstrap block and supported analytics install.
• Auto-installs analytics for Next App Router layouts and Vite/CRA-style index.html entrypoints.
• Refuses dirty worktrees unless --allow-dirty is explicit.
• Does not commit, push, or deploy.