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

# Slash commands

> Every built-in command you can type after / in the Cortex CLI composer, grouped by purpose, plus aliases and your own project commands

Type `/` in the composer and the command list opens, filtering as you type. Slash commands are how you reach everything the terminal app does that is not a message to the agent: sessions, model and policy, files, MCP servers, diagnostics, your account. A line beginning with `/` that is **not** a known command is not an error; it is sent to the agent as an ordinary message.

This page lists the built-in commands, grouped the way the in-app list groups them, with their aliases and their arguments. Most of them are also reachable another way, and several are usually reached by their alias rather than their full name: `/tasks` as `bg`, `/models` as `m`, `/shortcuts` as `keys`. At the end are the rules for adding commands of your own to a project.

<Note>
  Arguments in angle brackets are required and arguments in square brackets are optional, exactly as the in-app list shows them. A long list ends with a trailer such as `… 87 more — keep typing to filter`, so filtering is always the way through it.
</Note>

## App, help and display

| Command          | Aliases           | Usage                                           |
| ---------------- | ----------------- | ----------------------------------------------- |
| `/help`          | `h`, `?`          | `/help [topic]`                                 |
| `/shortcuts`     | `keys`            | Open the shortcuts sheet                        |
| `/settings`      | `config`, `prefs` | Open the settings panel                         |
| `/reload-config` | `reload`          | Re-read configuration from disk                 |
| `/theme`         |                   | `/theme [name]`                                 |
| `/compact`       |                   | Toggle the compact display                      |
| `/palette`       | `cmd`             | Open the command palette                        |
| `/copy`          | `cp`              | How to copy text out                            |
| `/version`       | `v`               | Show version information                        |
| `/upgrade`       | `update`          | Check for and install updates                   |
| `/experimental`  | `exp`, `features` | `/experimental [feature] [--enable\|--disable]` |
| `/cost`          |                   | Token usage and cost                            |
| `/ratelimits`    | `limits`, `quota` | Rate limits and usage                           |
| `/bug`           |                   | `/bug [description]`                            |
| `/quit`          | `q`, `exit`       | Quit                                            |

## Agents, skills, plugins and hooks

| Command            | Aliases            | Usage                           |
| ------------------ | ------------------ | ------------------------------- |
| `/agents`          | `subagents`        | List and manage agents          |
| `/delegates`       |                    | `/delegates [action]`           |
| `/tasks`           | `bg`, `background` | Background tasks and agents     |
| `/bg-process`      |                    | `/bg-process [action] [target]` |
| `/skills`          | `sk`               | List and manage skills          |
| `/skill`           | `invoke`           | `/skill <name> [args...]`       |
| `/skill-reload`    | `sr`               | Reload skills from disk         |
| `/plugins`         | `plugin`           | `/plugins [action] [plugin-id]` |
| `/hooks`           |                    | `/hooks [action]`               |
| `/commands`        | `cmds`             | List custom commands            |
| `/custom-commands` | `cc`               | `/custom-commands [action]`     |

Details are on [MCP servers in the CLI](/cli/mcp), [Skills in the CLI](/cli/skills), [Agents and subagents](/cli/agents), [Hooks](/cli/hooks) and [CLI plugins](/cli/plugins).

`/hooks` is the exception in this group. It is accepted and its actions are validated, but nothing handles it in this build: it answers `Unsupported command in this session` and does nothing. Use `cortex plugin list` instead, and see [Hooks](/cli/hooks) for how a hook reaches a session at all.

## Code and workflow

| Command               | Aliases          | Usage                                                 |
| --------------------- | ---------------- | ----------------------------------------------------- |
| `/init`               |                  | `/init [--force]`, writes `AGENTS.md`                 |
| `/review`             |                  | `/review [target] [--base=branch]`                    |
| `/multiedit`          | `sed`, `replace` | `/multiedit <pattern> <replacement> [--glob=pattern]` |
| `/ghost`              |                  | `/ghost [action]`, ghost commits for undo             |
| `/spec`               |                  | `/spec [off]`, toggle specification mode              |
| `/goal`               |                  | `/goal [objective\|status\|pause\|resume\|clear]`     |
| `/ide`                |                  | Manage IDE integration                                |
| `/install-github-app` |                  | Install the Cortex GitHub App                         |

`/spec` is on [Plan and Spec modes](/cli/plan-mode) and `/goal` is on [Goals](/cli/goal).

## Account, billing and usage

| Command    | Aliases                | Usage                                          |
| ---------- | ---------------------- | ---------------------------------------------- |
| `/login`   | `signin`               | Sign in                                        |
| `/logout`  | `signout`              | Clear stored credentials                       |
| `/account` | `whoami`, `me`         | Account information                            |
| `/billing` | `plan`, `subscription` | Billing status and credits                     |
| `/usage`   | `stats`, `credits`     | `/usage [--from YYYY-MM-DD] [--to YYYY-MM-DD]` |
| `/refresh` | `retry`                | Refresh billing after adding a payment method  |

Signing in from the terminal, including on a machine with no browser, is covered on [Sign in to the CLI](/cli/sign-in).

## Session

| Command       | Aliases               | Usage                                                           |
| ------------- | --------------------- | --------------------------------------------------------------- |
| `/session`    | `info`                | Current session details                                         |
| `/clear`      | `cls`                 | Clear the conversation                                          |
| `/new`        | `n`                   | Start a new session                                             |
| `/resume`     | `r`, `load`           | `/resume [session-id]`                                          |
| `/sessions`   | `list`, `ls-sessions` | List sessions                                                   |
| `/fork`       | `branch`              | `/fork [name]`                                                  |
| `/rename`     | `mv`                  | `/rename <name>`                                                |
| `/favorite`   | `fav`, `star`         | Mark as favourite                                               |
| `/unfavorite` | `unfav`, `unstar`     | Remove the favourite mark                                       |
| `/export`     | `save`                | `/export [format]`, Markdown, JSON or text                      |
| `/share`      |                       | `/share [duration]`, for example `30d`, `24h`, `60m` or `never` |
| `/timeline`   | `tl`                  | View the session timeline                                       |
| `/rewind`     | `rw`                  | `/rewind [steps]`                                               |
| `/undo`       | `u`                   | Undo the last action                                            |
| `/redo`       |                       | Redo                                                            |
| `/delete`     | `rm`                  | `/delete [session-id]`                                          |

<Warning>
  `/share`, `/fork` and `/rewind` exist only inside a session. There is no `cortex share`, `cortex fork` or `cortex rewind` command on the command line; the one non-interactive equivalent is the `--share` flag on `cortex run`. The commands that do exist outside a session are listed on [Command reference](/cli/reference).
</Warning>

## Navigation

| Command       | Aliases | Usage                      |
| ------------- | ------- | -------------------------- |
| `/diff`       | `d`     | `/diff [file]`             |
| `/transcript` | `tr`    | View the transcript        |
| `/history`    | `hist`  | Command history            |
| `/scroll`     |         | `/scroll <top\|bottom\|n>` |
| `/goto`       | `g`     | `/goto <n>`                |

## Files and context

| Command    | Aliases              | Usage                          |
| ---------- | -------------------- | ------------------------------ |
| `/add`     | `a`, `include`       | `/add <file>...`               |
| `/remove`  | `rm-file`, `exclude` | `/remove <file>...`            |
| `/search`  | `find`, `grep`       | `/search <pattern>`            |
| `/ls`      | `dir`, `files`       | `/ls [path]`                   |
| `/tree`    |                      | `/tree [path]`                 |
| `/mention` | `@`, `ref`           | `/mention <file\|symbol>`      |
| `/images`  | `img`, `pics`        | `/images <file>...`            |
| `/context` | `ctx`                | Show the current context files |

Typing `@` in the composer opens the file picker directly, which is the quicker path for adding context mid-sentence.

## Model and policy

| Command        | Aliases                            | Usage                                     |
| -------------- | ---------------------------------- | ----------------------------------------- |
| `/model`       | `models`, `m`, `lm`, `list-models` | `/model [name]`                           |
| `/approval`    | `approve`                          | `/approval <ask\|session\|always\|never>` |
| `/sandbox`     | `sb`                               | `/sandbox [on\|off]`                      |
| `/auto`        | `autopilot`                        | `/auto [on\|off]`                         |
| `/temperature` | `temp`                             | `/temperature <0.0-2.0>`                  |
| `/tokens`      | `max-tokens`                       | `/tokens <n>`                             |

`/model` and `/models` are the same command, so either spelling works, and `m` is the alias most people end up using. In the model list, `Tab` moves to the reasoning-effort controls and back; `/effort` is an alias that goes straight to them. Switching between Agent, Plan and Ask is `Shift+Tab` in the composer. What these controls actually permit is on [Modes and permissions](/cli/modes-and-permissions).

## MCP

| Command       | Aliases       | Usage                           |
| ------------- | ------------- | ------------------------------- |
| `/mcp`        |               | Interactive server management   |
| `/mcp-tools`  | `tools`, `lt` | List and manage MCP tools       |
| `/mcp-auth`   | `auth`        | MCP authentication              |
| `/mcp-reload` |               | Reload MCP server configuration |

## Diagnostics

| Command        | Aliases        | Usage                 |
| -------------- | -------------- | --------------------- |
| `/debug`       | `dbg`          | `/debug [on\|off]`    |
| `/status`      | `stat`         | Application status    |
| `/config`      | `cfg`          | `/config [key]`       |
| `/logs`        | `log`          | `/logs [level]`       |
| `/dump`        |                | `/dump [file]`        |
| `/metrics`     | `perf`         | Performance metrics   |
| `/diagnostics` | `diag`, `lint` | `/diagnostics [file]` |

## Your own commands

A project can carry its own commands. Put a markdown file in `.cortex/commands/` in the repository: the file name becomes the command and the body is the prompt it sends, so a command travels with the project and everyone working in it gets the same one.

* `/commands` (alias `cmds`) lists the custom commands it found.
* `/custom-commands [action]` (alias `cc`) manages them.

## If a command you read about is not there

The list that opens when you type `/` is the built-in set for the version you are running. Guides, blog posts and older notes sometimes name commands that the current build does not have, and because an unknown `/` line is sent to the agent as a message, typing one looks like nothing happened except an odd prompt. Three cases worth knowing:

* Switching mode is `Shift+Tab` in the composer.
* Specification mode is `/spec`.
* Approval behaviour is `/approval`, `/sandbox` and `/auto`.
* The model and its reasoning effort are both on the `/model` form, with `Tab` between them.

When in doubt, type `/` and read the list, or open `cortex --help` outside the app.

## Related

* [The TUI](/cli/tui): the composer, its sigils and the panels these commands open
* [CLI keyboard shortcuts](/cli/keyboard): what you can do without a command
* [CLI sessions](/cli/sessions): resume, fork, rewind, export and share in practice
* [Modes and permissions](/cli/modes-and-permissions): what the policy commands change
* [Command reference](/cli/reference): the commands and flags you type in your shell