Documentation

tracellm

Top-level TraceLLM CLI command reference.

Overview

The tracellm command is the top-level entry point for the TraceLLM SDK and developer CLI. When run without a subcommand, it opens an interactive command palette that lets you navigate and execute any TraceLLM operation using arrow keys.

Syntax

terminalCopy

bash

tracellm [COMMAND] [OPTIONS] [ARGS]

Available commands:

commandsCopy

text

start            Start the TraceLLM observability stack
trace            Run a production-style traced prompt simulation
replay           Replay a saved trace from MongoDB
monitor          Watch incoming traces in real time
export           Export traces from MongoDB
demo             Generate a realistic demo trace
create-project   Create a project and generate a secure API key

Interactive Palette

Running tracellm without any arguments launches a full-screen Rich TUI that lists every available command. Navigate with the arrow keys, press Enter to select, and press q or Esc to quit.

Tip

In headless environments where raw terminal input is unavailable, the palette falls back to a numbered menu automatically.

Global Options

Option	Description
--help	Show the help message and exit
--version	Show the installed TraceLLM version

Examples

terminalCopy

bash

# Open the interactive command palette
tracellm

# Show help for the CLI
tracellm --help

# Run a specific subcommand
tracellm trace "Explain quantum computing"

Common Errors

Error	Cause	Fix
No such command	Typo or unknown subcommand	Run tracellm --help to list valid commands
Palette not rendering	Terminal does not support raw input	The fallback numbered menu activates automatically

Troubleshooting

Warning

If the palette appears garbled, ensure your terminal supports ANSI escape sequences and has a minimum width of 80 columns.