Commands & Usage

Clarissa provides a conversational interface for interacting with AI. Simply type your questions or requests, and Clarissa will respond, using tools as needed.

Interactive Mode

Launch Clarissa in interactive mode:

clarissa

One-Shot Mode

Run a single command and exit:

clarissa "What files are in this directory?"

clarissa -m openai/gpt-4o "Explain this code"

Piped Input

Pipe content from other commands for AI processing:

cat error.log | clarissa "Explain this error"

git diff | clarissa "Write a commit message"

CLI Options

Slash Commands

Clarissa supports several slash commands for control and configuration. Type / to see suggestions:

Usage Examples

File Operations

Read the contents of package.json

Create a new file called hello.txt with "Hello, World!"

Find all TypeScript files containing "async function"

Git Operations

What's the current git status?

Show me the recent commit history

Stage all changes and commit with a descriptive message

Shell Commands

Run npm test and show me the results

What's my current disk usage?

Web Fetching

Fetch the Bun documentation homepage

What does the OpenRouter API documentation say about rate limits?

Tool Confirmation

When Clarissa attempts to use a potentially dangerous tool (like writing files or running shell commands), you'll be prompted to confirm:

⚠️ Tool: bash
Arguments: {"command": "rm -rf node_modules"}
Approve? (y/n)

Press y to approve or n to reject the action.

Session Management

Sessions are automatically saved when you exit Clarissa. You can also manually save with a custom name:

/save my-project-session

List saved sessions:

/sessions

Load a previous session:

/load session_id

Quickly load the most recent session:

/last

Or continue from the command line:

clarissa -c

Start a fresh conversation without exiting:

/new

Delete a session:

/delete session_id

Memory System

Clarissa can remember facts across sessions. Use the memory system to store information that should persist between conversations.

Save a memory:

/remember Always use TypeScript for new projects

List all memories:

/memories

Forget a memory by number or ID:

/forget 1

Memories are included in the system prompt, so Clarissa will consider them when responding to your requests.

Switching Models

View the current model:

/model

Change the AI model during your conversation:

/model openai/gpt-4o

This is useful for switching between models with different capabilities or costs.

Auto-Approve Mode

Toggle auto-approve mode to skip tool confirmation prompts:

/yolo

When enabled, Clarissa will automatically execute tools without asking for confirmation. Use with caution.

Context Window

Clarissa automatically tracks token usage and will truncate older messages when approaching the context limit. Use /context to see current usage.

Keyboard Shortcuts

Updating Clarissa

Clarissa checks for updates on startup and notifies you when a new version is available. To upgrade:

clarissa upgrade

Or from within interactive mode:

/upgrade

To manually check for updates:

clarissa --check-update