CLI Reference
uberprompt is the command-line tool for the prompt dependency graph, trace ingestion, and the proposal workflow.
Installation
The CLI lives in packages/cli and is available as @uberprompt/cli:
bash
pnpm --filter @uberprompt/cli exec uberprompt <command>Or link it globally:
bash
cd packages/cli && pnpm link --global
uberprompt <command>Global options
| Flag | Description |
|---|---|
--help | Show help for any command |
--json | Output machine-readable JSON (supported by graph, affected, infer) |
--no-color | Disable colored terminal output |
Commands
| Command | Description |
|---|---|
graph | Render the prompt dependency graph |
affected | Show prompts affected by file changes |
infer | Discover undeclared semantic edges |
init | Create trace-ingestion collections and indexes |
collect | Run an OTLP/HTTP span receiver |
tail | Print recent traces and stream new ones |
learn | Mine traces into deduped lessons (stage 2) |
compare | Compare prompt versions by traces, error rate, latency |
propose | Generate proposals from unprocessed lessons |
proposals | List pending proposals with inline diffs |
approve | Apply a proposal (snapshot, rewrite, version bump) |
reject | Mark a pending proposal as rejected |
sync-check | Check dependents for contradictions after a version bump |
Environment
The CLI reads MONGODB_URI from .env at the repo root for commands that interact with the database (init, collect, tail, learn, compare, propose, proposals, approve, reject, sync-check).
The graph, affected, and infer commands operate on the local file system (apps/demo/ prompt and edge files) and do not require a database connection.