CLI Overview

The lucerna CLI lets you index, search, and inspect codebases directly from the terminal — no code required.

Running without installing

Use a package manager’s runner to execute Lucerna as a one-off command:

npx @upstart.gg/lucerna <command>
# or
pnpm dlx @upstart.gg/lucerna <command>
# or
bunx @upstart.gg/lucerna <command>

For repeated use, install Lucerna globally so the lucerna binary is always available:

npm install -g @upstart.gg/lucerna
# or
pnpm add -g @upstart.gg/lucerna
# or
bun add -g @upstart.gg/lucerna

Then use it directly:

lucerna <command>

Command	Description
`index`	One-shot indexing of a project
`watch`	Index and re-index on file changes
`search`	Search an existing index
`graph`	Explore knowledge graph relationships
`stats`	Show index statistics
`clear`	Delete the index
`eval`	Measure recall@k against a query set