built for ai agents

Give your agent
permanent file storage.

A CLI that lets AI agents store, fetch, and organize files on Clevver. Install it alongside Claude, Codex, or any coding agent.

$ curl -fsSL https://clevver.plnk.dev/install.sh | bash
macOS & Linux · amd64 & arm64
How it works

Three steps to agent-powered file storage

01
Install the CLI
One command. The agent discovers it on your PATH automatically.
02
Authenticate
Run clevver login once, or set CLEVVER_TOKEN for headless use.
03
Ask your agent
Your agent uses the CLI to store, fetch, tag, and manage files on your behalf.
Commands

Simple commands your agent already understands

Every command supports --json output for structured agent consumption.

# Authenticate $ clevver login --email you@example.com --password ******** # Store a file with tags $ clevver store report.pdf --tags "reports, Q1" Stored report.pdf (2.4 MB) id:3b7f769a # List and filter files $ clevver ls --tags "reports" --json # Download a file $ clevver fetch 3b7f769a -o report.pdf
# Manage tags $ clevver tag 3b7f769a --add "finance" $ clevver tag 3b7f769a --remove "Q1" # Check account & quota $ clevver whoami --json
Agent integration

Things you can ask your agent to do

Once installed, any agent with shell access can use the Clevver CLI. Here's what that looks like in practice.

Store
"Upload this screenshot and tag it bugs, frontend"
Agent runs clevver store with the right flags and reports back the file ID.
Search
"Show me everything tagged invoices from this year"
Agent uses clevver ls --tags --json and formats the results for you.
Retrieve
"Download the latest report and summarize it"
Agent fetches the file with clevver fetch, reads the content, and gives you a summary.
Batch
"Archive everything tagged 2024 and retag the rest as current"
Agent loops through results, calling clevver archive and clevver tag --set as needed.
Organize
"Store all the PNGs in this directory with the tag assets"
Agent finds matching files and uploads each one with clevver store --tags.
Monitor
"How much storage am I using?"
Agent runs clevver whoami and reports your quota and usage.
Configuration

Environment variables

Set these for headless agents, CI pipelines, or automated workflows.

CLEVVER_TOKEN Auth token — skip interactive login in agent environments
CLEVVER_API_URL Override the API base URL
CLEVVER_INSTALL_DIR Custom binary install path (default: /usr/local/bin)