---
title: Install
description: Install the Nori CLI and run your first agent session.
status: draft
sidebar:
  order: 1
---

```sh
npm install -g nori-ai-cli
nori
```

macOS, Linux, and Android (Termux), on x64 and arm64. Prebuilt binaries are
also attached to [GitHub releases](https://github.com/tilework-tech/nori-cli/releases).

## First run

Bare `nori` opens the TUI. The default agent is Claude Code; switch any time
with `/agent` or launch with `nori -a codex` / `nori -a gemini`.

Nori reuses your agents' existing logins — authenticate once with each
provider's own CLI:

| Agent | Authenticate with | Or set |
|---|---|---|
| Claude Code | `npx @anthropic-ai/claude-code` then `/login` | `ANTHROPIC_API_KEY` |
| Codex | `/agent` to codex inside Nori, then `/login` | `OPENAI_API_KEY` |
| Gemini | `npx @google/gemini-cli` then `/auth` | `GOOGLE_API_KEY` |

## Where things live

Everything Nori writes goes under `~/.nori/cli/` (override with `NORI_HOME`):

```
~/.nori/cli/
├── config.toml      # your configuration
├── transcripts/     # session transcripts (JSONL, resumable)
├── history.jsonl    # prompt history
└── log/             # logs
```