AnythingLLM CLI

A command-line interface for chatting with your AnythingLLM instance from the terminal.

╔════════════════════════════════════════════════════════════════╗
║                                                                ║
║  █████  ███   ██ ██   ██ ████████ ██  ██ ██ ███   ██  ██████  ║
║ ██   ██ ████  ██  ██ ██     ██    ██  ██ ██ ████  ██ ██       ║
║ ███████ ██ ██ ██   ████     ██    █████  ██ ██ ██ ██ ██  ███  ║
║ ██   ██ ██  ████    ██      ██    ██  ██ ██ ██  ████ ██   ██  ║
║ ██   ██ ██   ███    ██      ██    ██  ██ ██ ██   ███  ██████  ║
║                                                                ║
║                    ██      ██      ██   ██                     ║
║                    ██      ██      ███ ███                     ║
║                    ██      ██      ██ █ ██                     ║
║                    ██      ██      ██   ██                     ║
║                    ███████ ███████ ██   ██                     ║
║                                                                ║
║    ✦ Chat with your AnythingLLM instance from the terminal ✦   ║
║                                                                ║
╚════════════════════════════════════════════════════════════════╝

Install

Install script (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/Mintplex-Labs/anything-llm-cli/main/install.sh | sh

This detects your platform, downloads the latest binary, and installs it to ~/.local/bin. Run it again to update.

Via package manager

npm install -g @mintplex-labs/anything-llm-cli
# or
yarn global add @mintplex-labs/anything-llm-cli
# or
pnpm add -g @mintplex-labs/anything-llm-cli
# or
bun install -g @mintplex-labs/anything-llm-cli

Standalone binary

Download a prebuilt binary from the Releases page and place it somewhere on your PATH.

| Platform | Binary | | ----------- | --------------------- | | macOS ARM | any-darwin-arm64 | | macOS Intel | any-darwin-x64 | | Linux x64 | any-linux-x64 | | Linux ARM | any-linux-arm64 | | Windows x64 | any-windows-x64.exe |

Quickstart

1. Get your API key from your AnythingLLM instance under Settings > Developer API.

2. Set your environment variables:

   macOS / Linux

   Run the interactive setup command to configure your environment automatically:

   any setup

   This will prompt you for your instance type, base URL, and API key, then write the appropriate exports to your shell config file (.zshrc, .bashrc, or config.fish).

   Windows

   Windows users need to set environment variables manually:

   # PowerShell (current session)
   $env:ANYTHING_LLM_BASE_URL = "https://my-instance.example.com"
   $env:ANYTHING_LLM_API_KEY = "your-api-key"
   
   # To persist across sessions, use System Environment Variables settings

3. Send your first prompt:

   any prompt "What is AnythingLLM?"

That's it! If no workspace is specified, the CLI will automatically create and use a default one.

Usage

any setup (alias: s)

Interactive setup wizard that configures your AnythingLLM connection. Prompts for your instance type (Desktop or Cloud/Self-Hosted), base URL, and API key, then writes the environment variables to your shell config file.

Note: Only available on macOS and Linux. Windows users must set environment variables manually.

any prompt <message> (alias: p)

Options

| Flag | Description | | ------------------------ | ---------------------------------------------------------------------------------------------------------------- | | -w, --workspace <slug> | Workspace slug. Falls back to ANYTHING_LLM_DEFAULT_WORKSPACE_SLUG env var, or auto-creates a default workspace | | -a, --attach <path...> | Attach image files to the prompt (png, jpg, jpeg, gif, webp) | | -t, --thread [slug] | Use a specific thread for the conversation | | --nt, --new-thread | Start a new thread for this conversation | | -S, --no-stream | Disable streaming (wait for full response) |

Examples

# Simple prompt (quotes optional)
any prompt What is AnythingLLM

# Pipe in context
cat error.log | any prompt "Explain these errors"
git diff | any prompt "Write a commit message for these changes"

# Use a specific workspace
any prompt "Hello" -w my-workspace

# Threads for ongoing conversations
any prompt "Let's talk about testing" --new-thread
any prompt "Continue where we left off" -t thread-slug

# Attach images
any prompt "What's in this image?" -a ./photo.png

# Scripting (no streaming, capture output)
RESULT=$(any prompt "Give me a one-word answer: yes or no?" -S)

# Save response to a file
any prompt "Write a summary" > summary.md

When piped or redirected, ANSI formatting is automatically stripped for clean plaintext output. Agent workspaces with tools (web browsing, scraping, etc.) are fully supported.

Environment Variables

| Variable | Required | Default | Description | | ------------------------------------- | -------- | ------- | ------------------------------------------------- | | ANYTHING_LLM_API_KEY | Yes | — | Your AnythingLLM API key | | ANYTHING_LLM_BASE_URL | Yes | — | Base URL of your AnythingLLM instance | | ANYTHING_LLM_DEFAULT_WORKSPACE_SLUG | No | — | Default workspace slug (avoids needing -w flag) |

Development

Requires Bun.

git clone https://github.com/mintplex-labs/anything-llm-cli.git
cd anything-llm-cli
bun run setup          # Install deps + create .env.local
bun run start prompt "Hello!"   # Run in development
bun run build          # Compile native binary → dist/any

Uninstall

# If installed via install script
sudo rm ~/.local/bin/any

# If installed via package manager
npm uninstall -g @mintplex-labs/anything-llm-cli