# `/ide` command reference

Pi × IDE registers the `/ide` command family in the Pi TUI for managing IDE
connections.

| Command        | Behavior                                                           |
| -------------- | ------------------------------------------------------------------ |
| `/ide`         | Open the TUI selector to list available IDE connections.           |
| `/ide status`  | Show the current connection, workspace, and most recent selection. |
| `/ide list`    | List candidate connections from the lock directory.                |
| `/ide auto`    | Re-attempt automatic matching by `cwd` and connect when matched.   |
| `/ide off`     | Disconnect and disable automatic context attachment.               |
| `/ide attach`  | Manually insert the latest selection range into the input box.     |
| `/ide install` | Install or update `balaenis.pi-x-ide` through a supported IDE CLI. |
| `/ide settings`  | Open IDE settings (`Display`, `AutoInstall`, …).                   |

### `/ide settings`

Unified settings entry. Layout:

```text
Settings:
→ Display       widget      IDE status placement: widget or statusline
  AutoInstall   true        Auto-install VS Code-family extension on startup
```

| Setting       | Values                 | Config key / env            | Default  |
| ------------- | ---------------------- | --------------------------- | -------- |
| `Display`     | `widget` / `statusline` | `status_display`            | `widget` |
| `AutoInstall` | `true` / `false`       | `env.PI_X_IDE_AUTO_INSTALL` | `true`   |

Keybindings:

| Key      | Action                                |
| -------- | ------------------------------------- |
| `↑`/`↓`  | Move between settings                 |
| `Space`  | Cycle the selected setting's value    |
| `Ctrl+S` | Save all settings to global config    |
| `Ctrl+P` | Save all settings to project config   |
| `Esc`    | Cancel without saving                 |

- **Global:** `~/.pi/pi-x-ide/config.json`
- **Project:** `<cwd>/.pi/pi-x-ide/config.json` (overrides global)

`Display` applies immediately in the current Pi session. See
[Configuration](configuration.md).

## The attach shortcut

Pi registers `Ctrl+Alt+K` in the TUI as a shortcut for `/ide attach` by default.
Repeated presses append the latest selected range to the current input, so you can
select multiple ranges in the editor and attach them one by one.

- **macOS:** this is a terminal shortcut (`Ctrl+Option+K`). `Cmd` shortcuts are
  handled by the terminal/OS and are not available to Pi's TUI.
- **Customize:** set `PI_X_IDE_ATTACH_SHORTCUT` to another pi key id.
- **Disable:** set `PI_X_IDE_ATTACH_SHORTCUT` to `off`, `none`, `false`, or `0`.

See [Configuration](configuration.md) for the full environment variable reference.