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
1 maintainer
Metadata
1 maintainer
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 | |
|---|---|---|---|
| plutus_cli-0.1.18.tar.gz | 29.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| plutus_cli-0.1.18-py3-none-any.whl | Python 3 | none | any | Details |
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
|
