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

# Interactive Menu: Navigating the CC Commander TUI

> Launch and navigate the CC Commander TUI: the main menu, guided sub-menus, keyboard shortcuts, mouse support, and the live Cockpit Dashboard status footer.

The CC Commander interactive menu is the primary way to work with the tool. When you run `ccc` in your terminal, you get a full terminal user interface (TUI) with arrow-key navigation, mouse support, and contextual sub-menus — no commands to memorize.

## Launching the menu

```bash theme={null}
ccc
```

This starts CC Commander in its default split mode: a tmux session with the menu in the left pane and Claude Code output in the right. If you want the menu without tmux, use:

```bash theme={null}
ccc --simple
```

## Main menu options

The main menu presents 15 choices. Use the arrow keys to move the selection, then press **Enter** to confirm. You can also click a menu item directly with your mouse.

| Key | Option                    | What it does                                                             |
| --- | ------------------------- | ------------------------------------------------------------------------ |
| `a` | Continue where I left off | Resume your last session (shown only if an active session exists)        |
| `o` | Open a project            | Import a local `CLAUDE.md` and `.claude/` context                        |
| `b` | Build something new       | Code, websites, APIs, CLI tools                                          |
| `c` | Create content            | Marketing, social media, writing                                         |
| `d` | Research & analyze        | Competitive analysis, reports, audits                                    |
| `e` | Review what I built       | Recent sessions and results                                              |
| `f` | Learn a new skill         | Browse 450+ skills and guides                                            |
| `g` | Check my stats            | Dashboard, streaks, achievements                                         |
| `l` | Linear board              | View issues, pick tasks, track work (shown only if Linear is configured) |
| `n` | Night Mode                | 8-hour autonomous build                                                  |
| `s` | Settings                  | Name, level, cost, theme                                                 |
| `t` | Change theme              | Switch the visual theme                                                  |
| `x` | Infrastructure & Fleet    | Fleet Commander, Synapse, Cost tracking, CloudCLI                        |
| `/` | Type a command            | Free-text prompt — describe anything or type a slash command             |
| `q` | Quit                      | Exit CC Commander                                                        |

## Sub-menus

Every main menu option opens a guided flow. Sub-menus always follow the same pattern:

1. A context header showing which section you are in and what is currently loaded.
2. A recommended action, marked with "(Recommended)", based on what you just did or what the project needs.
3. Three to five choices, always including "Something else — I'll tell you what I need" and a "Back" option.
4. After any action completes, CC Commander immediately prompts "What next?" with contextual suggestions.

You are never left at a dead end. Any sub-menu can be exited by pressing `Escape`, typing "back", or choosing the Cancel option.

<Steps>
  <Step title="Select a main menu option">
    Use the arrow keys to highlight a choice and press **Enter**, or click with your mouse.
  </Step>

  <Step title="Follow the guided flow">
    Each sub-menu asks a few focused questions — typically one sentence about what you want to build, research, or review.
  </Step>

  <Step title="CC Commander dispatches the task">
    The Intelligence Layer scores complexity, detects your stack, and configures the right model, budget, and skills automatically.
  </Step>

  <Step title="Review the result">
    After the task completes, CC Commander suggests logical next steps and returns you to the menu.
  </Step>
</Steps>

## Keyboard shortcuts

| Key             | Action                         |
| --------------- | ------------------------------ |
| `↑` / `↓`       | Move selection up or down      |
| `Enter`         | Confirm selection              |
| `Escape` or `q` | Cancel / back to previous menu |
| `?`             | Open the help popup            |
| Mouse click     | Select any menu item directly  |

## The `?` help popup

Press `?` from any menu screen to open the help popup. It shows a condensed reference of all keyboard shortcuts and tmux key bindings in a single overlay. Press `?` or `Escape` again to close it.

<Tip>
  The help popup also lists tmux shortcuts (`Ctrl+A n`, `Ctrl+A p`, etc.) when you are running in split mode. This is the fastest way to remind yourself of navigation keys without leaving the session.
</Tip>

## Cockpit Dashboard footer

Every menu screen renders a one-line status footer at the bottom of the terminal. It gives you a live snapshot of the current session state at a glance.

```text theme={null}
━━ CCC2.3.1│🔥Opus1M│🔑gAA│🧠▐██45%░░▌│⏱️▐██45%░░▌5h│📅▐██45%░░▌7d│💰$2.34│⬆️640K⬇️694K│⏰8h0m│🎯453│📋CC-150│📂~/project
```

Each segment maps to a specific piece of session data:

| Segment       | Icon | What it shows                                         |
| ------------- | ---- | ----------------------------------------------------- |
| Version       | `━━` | CC Commander version                                  |
| Model         | 🔥   | Active model — Opus, Sonnet, or Haiku                 |
| Auth          | 🔑   | Last 3 characters of your API key (or `OA` for OAuth) |
| Context       | 🧠   | Context window usage as a filled bar and percentage   |
| Session       | ⏱️   | Time elapsed within the current 5-hour session limit  |
| Weekly budget | 📅   | Spend within your 7-day rolling budget                |
| Cost          | 💰   | Session cost in USD                                   |
| Tokens        | ⬆️⬇️ | Input and output token counts                         |
| Time          | ⏰    | Total time in the current session                     |
| Skills        | 🎯   | Number of loaded skills                               |
| Linear ticket | 📋   | Current Linear ticket, if configured                  |
| Directory     | 📂   | Current working directory                             |

The bars color-code from green to yellow to red as context, rate limits, or budget approach their caps.

<Note>
  Footer values update each time you return to a menu screen. The bars color-code green → yellow → red as context, rate limits, or budget approach their caps.
</Note>
