Plutus CLI
Your AI assistant in the terminal. A full-featured command-line client for Plutus Cloud — chat with Plutus, manage email, connectors, memory, skills, workers, and more, all from your terminal.
Installation
pip install plutus-cli
Or install from source:
git clone https://github.com/Crypt0nly/plutus-cli.git
cd plutus-cli
pip install -e .
Quick Start
1. Authenticate
plutus login
You'll be prompted for your API key. Get it from app.useplutus.ai.
Alternatively, set the environment variable:
export PLUTUS_API_KEY="your-api-key"
2. Chat
Interactive mode — a full REPL with history, streaming, and tool call visibility:
plutus chat
One-shot mode — send a single message and get a response:
plutus ask "What emails did I get today?"
plutus ask "Deploy my app to Vercel"
plutus ask "Summarize the latest news about AI"
3. Manage Everything
plutus email inbox # Check your email
plutus email drafts # View drafts
plutus connectors list # See all connectors
plutus memory facts # View stored facts
plutus workers list # Check running workers
plutus schedule list # View scheduled jobs
Commands
Chat
| Command | Description |
|---|---|
plutus chat |
Interactive chat REPL |
plutus ask "message" |
One-shot message |
REPL commands: /help, /new (new conversation), /verbose (toggle tool output), /history, /exit
| Command | Description |
|---|---|
plutus email inbox |
List inbox messages |
plutus email read <id> |
Read a specific email |
plutus email drafts |
List drafts |
plutus email send-draft <id> |
Send a draft |
plutus email delete-draft <id> |
Delete a draft |
plutus email threads |
List email threads |
plutus email reply <id> "text" |
Reply to an email |
plutus email inboxes |
List configured inboxes |
plutus email domains |
List email domains |
Connectors
| Command | Description |
|---|---|
plutus connectors list |
List all connectors |
plutus connectors info <name> |
Show connector details |
plutus connectors setup <name> |
Configure a connector (interactive) |
plutus connectors test <name> |
Test a connector |
plutus connectors disconnect <name> |
Disconnect a connector |
Memory
| Command | Description |
|---|---|
plutus memory stats |
Memory statistics |
plutus memory facts |
List stored facts |
plutus memory facts -c "category" |
Filter facts by category |
plutus memory delete-fact <id> |
Delete a fact |
plutus memory goals |
List active goals |
plutus memory improvements |
View self-improvement log |
Skills
| Command | Description |
|---|---|
plutus skills list |
List all skills |
plutus skills info <name> |
Show skill details |
plutus skills export <name> |
Export skill to JSON |
plutus skills import <file> |
Import skill from JSON |
plutus skills delete <name> |
Delete a skill |
Custom Tools
| Command | Description |
|---|---|
plutus tools list |
List custom tools |
plutus tools create <name> <file> |
Create tool from Python file |
plutus tools delete <name> |
Delete a custom tool |
Workers
| Command | Description |
|---|---|
plutus workers list |
List active workers |
plutus workers cancel <id> |
Cancel a worker |
Scheduler
| Command | Description |
|---|---|
plutus schedule list |
List scheduled jobs |
plutus schedule create -n "name" -s "0 9 * * *" -p "prompt" |
Create a job |
plutus schedule delete <id> |
Delete a job |
plutus schedule pause <id> |
Pause a job |
plutus schedule resume <id> |
Resume a job |
plutus schedule history |
View execution history |
Contacts
| Command | Description |
|---|---|
plutus contacts list |
List contacts |
plutus contacts list -q "search" |
Search contacts |
plutus contacts info <id> |
Show contact details |
plutus contacts delete <id> |
Delete a contact |
Conversation History
| Command | Description |
|---|---|
plutus history list |
List recent conversations |
plutus history show <id> |
Show conversation messages |
plutus history delete <id> |
Delete a conversation |
plutus history clear |
Delete all conversations |
Workspace
| Command | Description |
|---|---|
plutus workspace ls |
List workspace files |
plutus workspace download <path> |
Download a file |
plutus workspace delete <path> |
Delete a file |
Configuration
| Command | Description |
|---|---|
plutus config model |
View model routing |
plutus config model -p anthropic -m sonnet |
Set model |
plutus config keys |
View API key status |
plutus config set-key <provider> <key> |
Set an API key |
plutus config delete-key <provider> |
Delete an API key |
plutus config usage |
View token usage |
plutus config heartbeat |
View heartbeat status |
Guardrails
| Command | Description |
|---|---|
plutus guardrails show |
View guardrail config |
plutus guardrails set-tier <tier> |
Set tier (minimal/standard/strict) |
plutus guardrails approvals |
List pending approvals |
plutus guardrails approve <id> |
Approve a tool call |
plutus guardrails deny <id> |
Deny a tool call |
Auth & Status
| Command | Description |
|---|---|
plutus login |
Authenticate with API key |
plutus logout |
Remove stored credentials |
plutus status |
Check connection status |
Configuration
Config is stored at ~/.plutus/config.toml:
api_key = "your-api-key"
api_url = "https://api.useplutus.ai" # optional, for custom deployments
You can also use environment variables:
export PLUTUS_API_KEY="your-api-key"
export PLUTUS_API_URL="https://api.useplutus.ai"
Requirements
- Python 3.10+
- A Plutus Cloud account with an API key
License
MIT
Metadata
Release files for plutus-cli 0.1.18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| plutus_cli-0.1.18.tar.gz | 29.3 kB | Without provenance | Details for plutus_cli-0.1.18.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| plutus_cli-0.1.18-py3-none-any.whl | Python 3 | none | any | Details for plutus_cli-0.1.18-py3-none-any.whl |
Total release size: 68.9 kB
Release files / plutus_cli-0.1.18.tar.gz
| Download URL | plutus_cli-0.1.18.tar.gz |
|---|---|
| Size | 29.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
60b2abf7645cdee5b7a46d58fc3926070b694da643baec3a351873a127b5b2ca
|
|
BLAKE2b-256 checksum How to use checksums |
3c6d5e2199a10cb12d5ad70128a5c93157e9ade8ec4751c6f6a8644350bbfa7b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Release files / plutus_cli-0.1.18-py3-none-any.whl
| Download URL | plutus_cli-0.1.18-py3-none-any.whl |
|---|---|
| Size | 39.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
95909cca56fbcc883c7310bb002b4c8b3c8ebe7d766e2fdf89cd83e5b9643e16
|
|
BLAKE2b-256 checksum How to use checksums |
70cc376ac1d8ba8c0aaff051b0171188a73b64b1f1e17066817edb3e4d8ebd83
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Security for plutus-cli 0.1.18
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.