> ## 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.

# Account and Models

> Sign in, check your profile, browse the models available to your account, and set the default model your terminal calls use.

`nito agent` manages the credential the terminal uses and the default model your calls run on. Sign-in happens in your browser, and the credential is stored in your operating system keychain, never a password in the terminal.

## Creating an Account

If you do not have a Nito account yet, start signup from the terminal. It opens your browser to the signup page:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Open the signup page in your browser
nito agent signup

# Print the signup URL instead of opening a browser
nito agent signup --no-browser
```

Use `--no-browser` on a headless machine or over SSH, then open the printed URL wherever you have a browser. Once your account exists, sign in with `nito agent login` below.

## Signing In

There is one credential for everyday use. How you create it depends on how you use Nito, and both paths open your browser for approval and store the credential in your operating system keychain; the profile file on disk holds only non-secret metadata.

**Using the plugin inside Claude Code or Codex?** Sign-in is part of setup. Installing the host integration signs you in at the same time:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
nito setup claude   # or: nito setup codex
```

Setup opens your browser once. Sign in and approve, and your keychain credential is created. See [Install in Claude Code](/plugin/get-started/install-claude-code).

**Using the terminal directly** (`nito ask`, `nito fusion`, the MCP bridge)? Sign in with `nito agent`:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Sign in through your browser
nito agent login

# Show the active profile and connectivity
nito agent status

# Sign out
nito agent logout
```

Both paths land on the same agent credential, so you do not sign in twice. `nito agent status` reports your profile, environment, authentication method, plan, and subscription state. Run it first whenever a command says you are not connected.

Nito never asks for a password in the terminal. Approval always happens in the browser, and the credential lives in your keychain. On a headless machine or over SSH, `nito agent login --method api-key --stdin` reads an API key from standard input instead of opening a browser.

### Signing In to the Gateway Directly

`nito auth login` signs the CLI in to the Nito gateway on its own, separate from the agent credential above. It targets the default Nito gateway, and `--base-url` points it at a specific one. Most plugin and terminal users only need `nito agent login`; reach for this when you are signing the CLI in to a particular gateway.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Sign in to the default gateway through your browser
nito auth login

# Device-code sign-in for a headless machine or SSH
nito auth login --no-browser

# Check or clear this sign-in
nito auth status
nito auth logout
```

## Browsing Models

List the models your account can use, with their privacy level and capabilities:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
nito agent models
```

Each row shows the **logical model ID** (what you pass to `--model`), its privacy level, and what it supports. See [Choosing a Model](/plugin/commands/choosing-a-model) for how to pick one, and [Models](/models) for the full catalog.

## Setting a Default Model

The default applies to terminal calls that do not pass `--model` (for example a bare `nito ask`).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Set your default model
nito agent model openai/gpt-5.5

# Show the current default
nito agent model status

# Clear it
nito agent model reset
```

A per-call `--model` always wins over the default. The default does not change the model your harness runs, only the model your direct Nito calls use.

## Options

| Flag | Effect |
| :- | :- |
| `--profile <name>` | Act on a specific agent profile instead of the default. |

## Related

<CardGroup cols={2}>
  <Card title="Choosing a Model" icon="list-check" href="/plugin/commands/choosing-a-model">
    How the saved default works with per-call overrides.
  </Card>

  <Card title="Nito CLI" icon="terminal" href="/plugin/cli/reference">
    Install, the command index, and the terminal front door.
  </Card>
</CardGroup>


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