> ## 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"},"languages":{"custom":["typescript","python","curl"]}}
# 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 only a credential reference in your operating system keychain, never a password in the terminal.

**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"},"languages":{"custom":["typescript","python","curl"]}}
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](/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"},"languages":{"custom":["typescript","python","curl"]}}
# 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.

<Note>
  Nito never asks for a password in the terminal. Approval always happens in the browser, and only a credential reference is kept locally. 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.
</Note>

### 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"},"languages":{"custom":["typescript","python","curl"]}}
# 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"},"languages":{"custom":["typescript","python","curl"]}}
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](/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"},"languages":{"custom":["typescript","python","curl"]}}
# 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="/commands/choosing-a-model">
    How the saved default works with per-call overrides.
  </Card>

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