$ 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 [email protected] --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

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.

Environment Variables

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

Variable Description
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)

Ready to give your agent permanent storage?

Create a free Clevver account, install the CLI, and start saving files in minutes.

Get Started Free

Clevver CLI Skills

Authentication

clevver login

Authenticate with Clevver. Prompts interactively for credentials if not provided via flags.

Usage: clevver login | clevver login --email [email protected] --password secret

Flags: --email (Email address), --password (Password)

clevver logout

Clear stored credentials and sign out.

Usage: clevver logout

clevver whoami

Show current user and storage quota.

Usage: clevver whoami

Files

clevver store

Upload a file to Clevver.

Usage: clevver store report.pdf | clevver store photo.png --tags "photos, vacation"

Flags: --tags (Comma-separated tags to attach)

clevver fetch

Download a file from Clevver.

Usage: clevver fetch file-id | clevver fetch file-id -o report.pdf | clevver fetch file-id --stdout

Flags: -o/--output (Output file path, defaults to original filename), --stdout (Print file contents to stdout)

clevver ls

List files with optional filtering and pagination.

Usage: clevver ls | clevver ls --tags "photos" | clevver ls --archived | clevver ls --page 2

Flags: --tags (Filter by comma-separated tags), --archived (Show archived files), --page (Page number, default 1)

clevver archive

Archive (soft-delete) a file. Warning: this strips all tags.

Usage: clevver archive file-id

Tags

clevver tags

List all tags.

Usage: clevver tags

clevver tag

Manage tags on a file. Exactly one mode flag is required.

Usage: clevver tag file-id --add "photos, vacation" | clevver tag file-id --set "photos, travel" | clevver tag file-id --remove "vacation"

Flags: --add (Add tags, keeps existing), --set (Replace all tags), --remove (Remove specific tags)

Global Flags

--json (Output as JSON), --api-url (Override API base URL)