Guides

These guides are short, goal-named recipes. Each one assumes kli is installed and running, and takes you straight to a single outcome. For the reasoning behind a recipe, follow the links into Concepts; for exact flags and keys, see Reference.

Models and auth

• Switch between models and reasoning options — Choose and switch models
• Sign in to a provider — Connect a provider
• Point kli at a local or self-hosted endpoint — Add a custom OpenAI-compatible provider

Running a session

• Run shell commands and evaluate Lisp — Run commands and eval Lisp
• Redirect kli while a turn is in flight — Steer a running turn
• Get comfortable in the interface — Work in the TUI
• Script kli or pipe input into it — Run kli headless or piped

Sessions and context

• Save your work and reopen it later — Persist and resume sessions
• Keep a long conversation under control — Manage long conversations
• See and edit what the model sees — Inspect and edit context

Customizing and operating

• Switch or define a profile — Switch and customize profiles
• Gate the tools kli may use — Restrict what kli can do
• Record an event log — Log observability events
• Move to a newer build — Update kli