Installation

cargo install --path crates/sage-cli

CLI Modes Overview

This CLI provides multiple execution modes for different use cases:

1. Interactive Mode (Default)

Start a conversation loop where you can have multi-turn conversations with the AI. The AI remembers context across messages within the same conversation.

Use when: You want to have a back-and-forth conversation, iterating on tasks
Command: sage or sage interactive
Example: Ask the AI to create a file, then ask it to modify that file

2. Run Mode (One-shot)

Execute a single task and exit. Best for automation and scripting. The AI completes the task and returns immediately.

Use when: You have a single, well-defined task to complete
Command: sage run "<task>"
Example: sage run "Create a Python hello world script"

3. Unified Mode (Advanced)

New execution model with inline user input blocking. Supports both interactive and non-interactive modes via flag.

Use when: You need fine-grained control over execution behavior
Command: sage unified "<task>"
Example: sage unified --non-interactive "Run tests"

4. Utility Commands