Baloo CLI

A command-line interface for interacting with the Baloo API, focusing on project management operations.

Installation

cargo build --release

The binary will be available at target/release/baloo.

You can install it globally with:

cargo install --path .

Configuration

The CLI connects to api.baloo.app (production) by default using HTTPS.

Local Development

To connect to your local development server instead:

baloo --local project list
# or use shortcuts:
baloo -l p list

The --local (or -l) flag connects to localhost:8080 using HTTP.

Usage

Authentication

Before using the CLI, you must authenticate:

baloo login

This will:

1. Open your browser automatically (or display a URL to visit)
2. Prompt you to authorize the application via Auth0
3. Save your credentials securely in ~/.config/baloo/token.json (macOS/Linux) or %APPDATA%\baloo\token.json (Windows)

Check authentication status:

baloo whoami

Log out:

baloo logout

Projects

You can use projects or the shortcut p:

List all projects

baloo projects list
# or: baloo p list

Get a single project

baloo projects get <project-id>

Create a new project

baloo projects create --name "My Project" --description "Project description"

Edit a project

baloo projects edit <project-id> --name "New name"
baloo projects edit <project-id> --description "New description"
baloo projects edit <project-id> --name "New name" --description "New description"

Delete a project

baloo projects delete <project-id>

Archive a project

baloo projects archive <project-id>

Restore an archived project

baloo projects restore <project-id>

View project history

baloo projects history <project-id>
baloo projects history <project-id> --limit 50 --offset 20

Undo the last change

baloo projects undo <project-id>

Revert to a specific version

baloo projects revert <project-id> --version 5

Chats

You can use chats or the shortcut c:

List all chats

baloo chats list
# or: baloo c list

Get a chat with full message history

baloo chats get <chat-id>

Send a message to the LLM

baloo chats send -m "What are my active projects?"
# or: baloo c send -m "Hello"

Continue an existing chat

baloo chats send --chat <chat-id> -m "Tell me more"
# or: baloo c send -c <chat-id> -m "Tell me more"

Send a message with context items

baloo chats send -m "Analyze this file" --context file:abc-123:mydoc.pdf
baloo chats send -m "What's in my project?" --context project:def-456:MyProject

Show recent messages before response

baloo chats send --chat <chat-id> -m "Continue" --recent 3
# or: baloo c send -c <chat-id> -m "Continue" --recent 3

Sources

You can use sources or the shortcut s:

List all sources

baloo sources list
# or: baloo s list

List sources for a specific project

baloo sources list --project <project-id>
# or: baloo s list -p <project-id>

Get a single source

baloo sources get <source-id>

Create a text source

baloo sources create --text-content "My notes here" --name "My Notes"
# Attach to a project:
baloo sources create --text-content "Notes" --name "Notes" --project <project-id>
# or: baloo s create --text-content "Notes" -p <project-id>

Update a source

baloo sources update <source-id> --name "New Name"
baloo sources update <source-id> --project <project-id>
# Remove from project:
baloo sources update <source-id> --project none

Delete a source

baloo sources delete <source-id>

Help

Get help for any command:

baloo --help
baloo projects --help
baloo projects create --help

Examples

# First, authenticate
baloo login

# Create a new project
baloo projects create --name "Website Redesign" --description "Redesign company website"

# List all projects
baloo projects list

# Get detailed info about a project
baloo projects get abc123-def456-789

# Edit project name
baloo projects edit abc123-def456-789 --name "Updated Name"

# View project history
baloo projects history abc123-def456-789

# Undo last change
baloo projects undo abc123-def456-789

# Archive project
baloo projects archive abc123-def456-789

# Use local development server
baloo -l projects list