OdyshellInstall Machines and operate the Human control plane with ods.
ods works on Windows, Linux, and macOS with Node.js 24 or newer.
npm install --global @odyshell/cliods login opens the system browser and completes Authorization Code OAuth with PKCE. Access and
refresh tokens are stored with user-only filesystem permissions and are never printed.
ods login
ods machines list
ods agents list
ods sessions list
ods sessions timeline <session-id>Owners and Admins can manage Agent roles and removal. Every Organization role can supervise a pending Standard-Agent Session.
ods agents role <agent-id> operator
ods agents role <agent-id> standard
ods agents remove <agent-id> --yes
ods sessions approve <session-id>
ods sessions deny <session-id>The same OAuth session can act as an Agent through the canonical API:
ods sessions request --machine <id> --duration 1h --title "Deploy release"
ods commands run <session-id> --command "git status"
ods commands get <command-id>
ods commands output <command-id>
ods sessions complete <session-id>Durations are 15m, 1h, 2h, 6h, 8h, or 24h. Use --json for stable automation and
--server or ODYSHELL_SERVER_URL for self-hosting.
In Machines, select Add Machine and run the generated command on the target host:
ods --server https://api.example.com up --token <single-use-token> --name production-apiods up verifies Server health, writes the Machine identity and Local Policy, and installs a
restartable systemd, launchd, or Windows Task Scheduler user service. The token expires after ten
minutes, works once, and is never saved.
Local Client commands include ods status, ods profiles ls, ods client doctor, ods client update --check, ods down, and ods reset --yes.