plori CLI
Install the CLI, complete browser login, run an agent, use JSON output in scripts, and keep API-key auth for CI.
The plori CLI creates and runs your cloud agents from a terminal or a script. It shares the same account, agents, and files as the web app and the MCP server.
Install and sign in
npm i -g @plori/cli
plori login
plori login opens the email-OTP page in your browser. A new email creates an account;
an existing email signs back in. The CLI returns once the browser completes the
sign-in.
The browser flow requests the openid offline_access mcp scopes and writes the
credentials to ~/.config/plori/config.json (or $XDG_CONFIG_HOME/plori/config.json),
file mode 0600. Stored fields: the public OAuth client id, a short-lived access token,
a rotating refresh token, their expiry, and the granted scopes. The CLI refreshes the
session automatically. plori logout clears the stored credentials.
For CI or headless environments, create an API key at Dashboard → Settings → API keys:
plori login --key plori_sk_…
# or, without writing a config file
export PLORI_API_KEY=plori_sk_…
First agent and first run
plori create mate
plori run mate "Research this topic and save the result to work/report.md"
create gets or creates by name, so running it again reuses mate instead of making a
duplicate. run waits for the reply by default. For longer work:
plori run mate "Run the full test suite" --no-wait
plori result mate <run-id> --wait
plori run mate "Build it and stream progress" --follow
Scripts and automation
Every command accepts --json. Piping stdout switches to JSON automatically, so
plori agents | jq . works without the flag. Progress and errors stay on stderr.
plori agents --json
plori credits --json
plori workflows list --json
Use plori schedule for one future agent turn and plori workflows for standing
automations. Run plori help for the complete command list.
Credits
plori credits shows the balance and prints a billing link when credits run low. Any
command refused with HTTP 402 prints a billing link too. See
pricing for plans and one-time credit packs.