magnitude CLI. In a new terminal, run:
magnitude without a subcommand prints help. No npm installation is required.
Run Magnitude
Model, catalog, hardware, and connection setup commands require a running Desktop or
magnitude serve.
Stop a foreground server with Ctrl+C. Opening Desktop takes over from a foreground server.
Only one Desktop or serve instance can run under the same user account. Fully quit Desktop or stop the existing serve command before starting another server. See Remote server for setup.
Use Launch at login in Desktop Settings for login startup, and Quit Magnitude to stop Desktop.
Find and download models
Assessment and downloads run in the background. Use status commands to check progress.
Prefix each command with
magnitude. Recommendation preferences are fastest, faster, balanced, smarter, and smartest; use --preference and --limit to choose.
Connections
connections connect accepts --set-model <model-id> to select a model and --install-skill to install or refresh its Magnitude skill. Skill installation is automatic for Pi.
Harness IDs: pi, opencode, hermes, openclaw, codex, claude-code, oh-my-pi, and cline. See Integrations for agent-specific instructions.
Updates
These commands update Desktop, the server, and CLI together. Checking, downloading, inspecting, or discarding an update does not open Desktop.
update install refuses to interrupt a running serve command. Stop the server first. Installation leaves a stopped server stopped; run magnitude serve afterward. A prepared update is also installed at the next startup unless an earlier installation attempt failed. Failed attempts require an explicit update install retry. Linux installation may require administrator authorization.
Help
Use--help after any command to see its options. magnitude --version prints the installed CLI version. magnitude docs lists documentation bundled with the CLI, and magnitude docs cli prints its command guide.
Configuration
Settings are stored in~/.magnitude/config.json. See Configuration file.