> ## 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"}}
    /nito:session [--model <id>] [--web-search off|auto|on] [--web-fetch=off|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"}}
    $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](/plugin/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](/plugin/cli/session-launchers).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.