> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trynito.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Session

> Open a separate, persistent session powered entirely by a model through Nito, with your workspace and history retained.

`session` opens a separate harness session in your current workspace that is powered **entirely by a model through Nito**. Unlike Private, it is meant to be lived in: it keeps your prompt history, transcripts, and project state, so you can work a task over many turns on a model through Nito instead of your harness's default.

## Syntax

<Tabs>
  <Tab title="Claude Code">
    ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["typescript","python","curl"]}}
    /nito:session [--model <id>] [--web-search off|auto|on]
    ```

    Opens a persistent, Nito-routed Claude session in a separate terminal for the current workspace.
  </Tab>

  <Tab title="Codex">
    ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["typescript","python","curl"]}}
    $nito:session [--model <id>] [--web-search off|auto|on]
    ```

    Opens a persistent, Nito-routed Codex session in a separate terminal for the current workspace.
  </Tab>
</Tabs>

Without `--model`, the session uses your saved [default model](/commands/choosing-a-model). It does not accept an inline prompt or the Private-only options (`--ephemeral-history`, `--skip-permissions`).

## Private vs. Session

They both route away from your harness's default model, but they are opposites on persistence:

|                               | Private (no prompt)      | Session                  |
| :---------------------------- | :----------------------- | :----------------------- |
| Keeps prompt history          | No                       | Yes                      |
| Keeps transcripts             | No                       | Yes                      |
| Keeps project memory / resume | No                       | Yes (harness-dependent)  |
| Purpose                       | Throwaway incognito turn | Ongoing Nito-routed work |
| Inline prompt accepted        | Yes (one-shot form)      | No                       |

Use **Private** for a turn that should leave no trace; use **Session** for sustained work you want to keep, routed through Nito.

## What Runs Inside a Session

A Nito session is a normal harness session with the model pinned to Nito:

* Your harness's **native model picker** works, restricted to eligible Nito chat models on the session's privacy level so it cannot break the session's guarantees.
* Your harness's **agents/subagents and tools** work, running against the Nito catalog.
* **Anonymous, Private, and Confidential** models can power a session. An `:encrypted` model cannot, because Encrypted is [coming soon to the plugin](/privacy/levels/encrypted) and the client refuses it on every path, not only in sessions.

## First-Release Notes

* **Codex:** wrapper-owned resume is not yet available. Transcripts and local state are retained in a dedicated Nito profile without changing your ordinary Codex configuration.
* **Claude Code:** the session runs with a dedicated local Nito profile. Some harness features that depend on the provider (for example newly-requested extended thinking and experimental betas) are disabled for this first release; visible assistant text and tool history are preserved.
* Exiting the session and launching your harness normally returns you to your ordinary model.

## From the Terminal

The same session can be launched directly from the command line tool without a harness command. See [Session Launchers](/cli/session-launchers).