Quickstart: Tempr CLI
Install the CLI, sign in with your Tempr license key, and run your first agent turn from the terminal — usually under two minutes.
-
Install the CLI
The CLI ships as a .NET global tool (requires the .NET SDK) and runs on Windows, macOS, and Linux:
dotnet tool install -g Tempr.Cli -
Sign in
Authenticate once with the same license key you use in the IDE:
tempr auth -
Pick a default model
Any model from your plan's catalog on a provider you've configured works — set a default and override it per-prompt when you want:
tempr config set-model <id> -
Run your first turn
One-shot a task from your repo's root, or start an interactive session:
tempr "explain this repo" tempr
Three ways to run it
| Invocation | Behavior |
|---|---|
tempr "<prompt>" | One-shot. A full agent turn with real tool-calling — file read/write/edit, run_command, and semantic search — then exits. |
tempr | Interactive REPL. Persistent cross-session history, line editing, and tab-completion for /commands and @personas. |
<something> | tempr | Piped / headless. Reads stdin, writes to stdout — composable like any other command-line tool. |
Personas and plain chat
The built-in specialist personas work on the command line with the same names as the IDE:
tempr @debugger "why does this fail"If you want a quick answer with no file access or commands, use ask mode:
tempr --ask "what's the difference between IActionResult and ActionResult?"Managing your setup
| Command | Does |
|---|---|
tempr config | Manage settings and your default model. |
tempr history | Browse saved sessions. |
tempr mcp | Add, list, and manage MCP servers. |
tempr doctor | Check connectivity and diagnose your setup. |
tempr --help | Full command reference. |
The CLI runs on your existing Tempr Chat license — there's no separate subscription. The agent loop runs server-side, so a dropped connection doesn't lose an in-flight turn.
Next steps
- CLI command reference — every command, flag, REPL shortcut, and the agent tool set.
- Scripts, pipes & CI — headless patterns and the JSON event stream.
- Providers & BYOK — the supported-provider list behind your model choices.
- Agent modes & personas — the persona lineup and how delegation works.
- MCP servers — extend the agent with your own tools and data sources.