OdyshellInstall and operate the Linux Machine Client with `ods`.
ods is a Machine administration tool. Agents use remote OAuth MCP or canonical HTTP; they do
not execute the CLI.
Requires Linux and Node.js 24 or newer:
npm install --global @odyshell/cliRegister the Agent first. In Machines, select Add Machine, choose that Agent, and run the generated command on the target host:
ods --server https://api.example.com up \
--token <single-use-token> \
--name production-api \
--agent-id <agent-id>The token expires after ten minutes, is consumed once, and is never saved. ods up writes the
Machine identity and Local Policy, verifies Server health, and installs a restartable systemd user
service.
ods status
ods profiles ls
ods profiles status default
ods client status --profile default
ods client doctor --profile default
ods client update --check --profile default
ods down --profile default
ods up --profile default
ods profiles remove default
ods reset --yesUse --json for stable local automation. Use --server or ODYSHELL_SERVER_URL for a self-hosted
Server. Named Profiles keep independent Machine identities and systemd services; --profile and
--config cannot be combined.
ods client start --config <path> is the foreground process invoked by the generated service.
The CLI has no Human login, Agent runtime, Task, Command, shell, filesystem, Docker, Session, or local MCP commands. Remote OAuth and the canonical Server protocol own authorization, idempotency, reconnect, and audit behavior.