Overview - Motus

The motus command is the entry point for the Motus Agent Framework CLI. Use it to run agents locally as HTTP servers, interact with them from the terminal, and deploy them to Motus Cloud.

Usage

motus <command> [options]

If no command is given, motus prints the help message and exits.

Environment variables

Variable	Description
`LITHOSAI_API_KEY`	API key for Motus Cloud. When set, replaces credential-file authentication for `deploy`, `login`, `logout`, and `whoami`.
`LITHOSAI_API_URL`	Override the default Motus Cloud API endpoint (`https://api.lithosai.cloud`).

Configuration files

Motus reads project-level settings from motus.toml in the working directory. After a successful deploy, the CLI writes project_id, build_id, and import_path to this file so that subsequent commands can run without flags. See Configuration for details.

Subcommands

Command	Description
`motus serve`	Start an agent HTTP server and interact with it
`motus deploy`	Package and deploy an agent to Motus Cloud
`motus login`	Authenticate with Motus Cloud
`motus logout`	Revoke credentials and clear the local credential file
`motus whoami`	Print the identity associated with your current credentials

​Usage

​Environment variables

​Configuration files

​Subcommands

Usage

Environment variables

Configuration files

Subcommands