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

# Terminal chat

> Chat with the Nisa agent in your terminal — the same sessions as the web app — and give it your files.

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
nisa
```

Signs you in on first run (browser, or paste a key), then opens the chat in the folder you launched from. Sessions are the web app's sessions: start in one, continue in the other. `nisa tui --session-id <id>` opens one directly.

## Everyday commands

| Command                                                                  | Does                                                  |
| ------------------------------------------------------------------------ | ----------------------------------------------------- |
| `/help`                                                                  | Command palette                                       |
| `/new` · `/open <id \| index \| query>` · `/next` · `/prev` · `/refresh` | Sessions                                              |
| `/research <question>`                                                   | Put the agent in research mode on a question          |
| `/interrupt`                                                             | Stop the current turn                                 |
| `/retry`                                                                 | Resend your last message as a fresh turn              |
| `/doc [save <path>]` · `/artifact <id> [save <path>]`                    | View or save the session's research doc / an artifact |
| `/inspect [summary\|tools\|papers\|usage\|close]`                        | Detail inspector for the session                      |
| `/permissions …` · `/status` · `/connect <token>` · `/disconnect`        | Local access and the web-chat bridge                  |
| `/quit`                                                                  | Exit — or `q`, or `Ctrl-C` twice within 1.5 s         |

<Accordion title="Everything else">
  | Command                                                              | Does                                                                                            |
  | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
  | `/sandbox [status\|kill]`                                            | Status of the session's sandbox, or terminate it                                                |
  | `/delete [confirm]`                                                  | Delete the current session (confirm within 10 s)                                                |
  | `/sidebar show\|hide\|toggle` · `/focus sessions\|transcript\|input` | Layout and keyboard focus                                                                       |
  | `/logout` · `/upgrade` · `/dismiss-upgrade`                          | Sign out and delete local credentials · exit and run the installer · silence the upgrade banner |
  | `//text`                                                             | Send a message that starts with a slash                                                         |
</Accordion>

`Esc` goes back. `Ctrl-C` once interrupts a running turn (on an idle session it only arms the quit window).

## Local access

Defaults: the agent can **read** the launch folder; it can't write or run commands. Your own `!cmd` shell commands are on.

| Goal                               | Command                                                                       |
| ---------------------------------- | ----------------------------------------------------------------------------- |
| Show current settings              | `/permissions` (alias `/approvals`) · `/status`                               |
| Turn local access off / on         | `/permissions off` · `/permissions on`                                        |
| Read files only (default)          | `/permissions read-only`                                                      |
| Let the agent create or edit files | `/permissions workspace-write` (or `allow-writes`; revoke with `deny-writes`) |
| Let the agent run commands         | `/permissions shell-exec` (or `allow-exec`; revoke with `deny-exec`)          |
| Your own `!cmd` on (default) / off | `/permissions terminal on` · `/permissions terminal off`                      |
| Change the folder                  | `/permissions workspace <dir>`                                                |

`!ls` runs locally and puts the output in the chat as context. `!!` sends a literal `!`.

Bridging a web chat to this folder: [Connect a folder](/docs/nisa/guides/connect-a-folder). Headless session control: [CLI reference → Sessions](/docs/nisa/reference/cli#sessions).