# 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](/kli/concepts); for exact flags and keys,
see [Reference](/kli/cli).

## Models and auth

- Switch between models and reasoning options — [Choose and switch models](/kli/guides/choose-and-switch-models)
- Sign in to a provider — [Connect a provider](/kli/guides/connect-a-provider)
- Point kli at a local or self-hosted endpoint — [Add a custom OpenAI-compatible provider](/kli/guides/add-a-custom-openai-compatible-provider)

## Running a session

- Run shell commands and evaluate Lisp — [Run commands and eval Lisp](/kli/guides/run-commands-and-eval-lisp)
- Redirect kli while a turn is in flight — [Steer a running turn](/kli/guides/steer-a-running-turn)
- Get comfortable in the interface — [Work in the TUI](/kli/guides/work-in-the-tui)
- Script kli or pipe input into it — [Run kli headless or piped](/kli/guides/run-kli-headless-or-piped)

## Sessions and context

- Save your work and reopen it later — [Persist and resume sessions](/kli/guides/persist-and-resume-sessions)
- Keep a long conversation under control — [Manage long conversations](/kli/guides/manage-long-conversations)
- See and edit what the model sees — [Inspect and edit context](/kli/guides/inspect-and-edit-context)

## Customizing and operating

- Switch or define a profile — [Switch and customize profiles](/kli/guides/switch-and-customize-profiles)
- Gate the tools kli may use — [Restrict what kli can do](/kli/guides/restrict-what-kli-can-do)
- Record an event log — [Log observability events](/kli/guides/log-observability-events)
- Move to a newer build — [Update kli](/kli/guides/update-kli)