Inspect your org, model changes in scenarios, and give Codex or Claude Code a safer surface for live reads and draft work.
Agent-ready
Use the optional orgonaut-cli skill with Codex or Claude Code.
Reporting
Trees, summaries, rosters, velocity, and lineage.
Safe writes
Inspect Live, then switch into a scenario to explore the impact.
One command to install
Install the standalone CLI from the app host.
curl -fsSL https://app.orgonaut.co/cli/install.sh | shThe binary is enough for terminal work. The companion skill is optional for Codex and Claude Code.
Use the hosted installer for the normal setup path. If you prefer to fetch binaries directly, use the app-hosted release URLs below.
Install
The hosted installer fetches the correct standalone binary from stable Orgonaut download URLs.
curl -fsSL https://app.orgonaut.co/cli/install.sh | shThen log in
Approve the browser prompt on your tenant host, then return after the success confirmation.
orgonaut auth login --tenant acmePrefer a direct download? Use the app-hosted release URLs below for stable binaries and versioned assets.
Install the CLI for terminal work. Add the hosted orgonaut-cli skill when you want an agent to use the same guardrails.
The skill is optional. It teaches the tenant-first login flow, the post-login checks, the live-versus-scenario boundary, and the JSON discovery commands that match the shipped CLI surface.
Use orgonaut auth login --tenant <slug> and approve the browser prompt on your tenant host.
Run orgonaut doctor and orgonaut context show before deeper work starts.
Keep live mode read-only and use scenario context for writes.
Use orgonaut commands --json and orgonaut help <path> --json for discovery.
Prefer to pin a released version? Swap the latest manifest URL for https://app.orgonaut.co/cli/skills/vX.Y.Z/orgonaut-cli/SKILL.md.
Codex
Install the latest hosted skill into Codex's skills directory.
mkdir -p ~/.codex/skills/orgonaut-cli
curl -fsSL https://app.orgonaut.co/cli/skills/latest/orgonaut-cli/SKILL.md \
-o ~/.codex/skills/orgonaut-cli/SKILL.mdClaude Code
Install the same hosted skill into Claude Code when you want it to use the CLI safely.
mkdir -p ~/.claude/skills/orgonaut-cli
curl -fsSL https://app.orgonaut.co/cli/skills/latest/orgonaut-cli/SKILL.md \
-o ~/.claude/skills/orgonaut-cli/SKILL.mdUse the CLI for reporting, safe scenario work, and commands that humans and agents can use without guesswork.
The optional skill pushes Codex and Claude Code to ask the CLI what is supported before acting.
$ orgonaut commands --json
$ orgonaut help report org-units summary --json
$ orgonaut help scenario positions create --json
Confirm connectivity, auth, tenant, and mode before a human or agent does anything else.
$ orgonaut doctor
CONNECTIVITY AUTH TENANT CONTEXT
ok ok acme live
$ orgonaut context show
PROFILE TENANT MODE
acme-prod * acme live
$ orgonaut context scenario use q3-restructure
Scenario context saved.
Use tree views, summaries, rosters, velocity, and lineage as direct inputs for planning and review.
$ orgonaut live org-units tree
$ orgonaut report org-units summary
$ orgonaut report org-units roster
$ orgonaut report teams velocity
$ orgonaut report scenarios lineage
Create the scenario, switch into it, inspect the delta, and submit when the plan is ready.
$ orgonaut scenario create --name "Q3 Restructure"
$ orgonaut context scenario use q3-restructure
$ orgonaut scenario positions create --input position.json
$ orgonaut scenario delta
$ orgonaut scenario submit
Use the browser path for normal setup. Use --token only for CI, automation, or headless hosts.
Run orgonaut auth login --tenant acme, approve the
browser prompt on your tenant host, and return after the success
confirmation. The CLI saves a local profile automatically so you or
an agent can keep working from the same context.
This is the same login path the optional companion skill teaches to
Codex and Claude Code. Use --token only when there is no browser available.
CI or headless login
Use a pre-created CLI-capable token only when browser login is not available.
orgonaut auth login \
--tenant acme \
--token '<bearer-token>'Choose the binary that matches your environment. Each asset links to the app-hosted direct download URL.
Use the same command surface for live reads, reporting, scenario work, and agent-driven workflows.