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

# CLI reference

> Every command in the grid shell

The `grid` shell is the entry point to the platform — install it with the
one-liner from the portal, run `grid`, and type `help` at any time. This
page lists every available command.

## Sessions

| Command                               | Description                                            |
| ------------------------------------- | ------------------------------------------------------ |
| `session start [sim \| robot [name]]` | Start working — a session against a simulator or robot |
| `session list`                        | List active sessions                                   |
| `session stop [id]`                   | Stop a running session                                 |

## Robots

| Command      | Description                                       |
| ------------ | ------------------------------------------------- |
| `robot list` | List your robots — enter to view a robot's config |
| `robot add`  | Onboard a new robot (wizard)                      |

## Environment

| Command  | Description                                       |
| -------- | ------------------------------------------------- |
| `login`  | Log in to the active GRID cluster in your browser |
| `switch` | Switch to a different GRID cluster                |

## Troubleshooting

| Command           | Description                                     |
| ----------------- | ----------------------------------------------- |
| `error`           | Show details of the last error                  |
| `diagnostics`     | Bundle logs + config into a tarball for support |
| `debug [on\|off]` | Toggle verbose logging with inline stack traces |

## Utilities

| Command              | Description                                                      |
| -------------------- | ---------------------------------------------------------------- |
| `help [command]`     | Show help information                                            |
| `theme [grid\|mono]` | Switch the color theme for this session — mono renders grayscale |
| `clear`              | Clear the terminal                                               |
| `exit`               | Exit GRID CLI                                                    |


## Related topics

- [Your first skill](/get-started/first-skill.md)
- [Your first session](/get-started/first-session.md)
- [Get started](/get-started/installation.md)
- [grid-cortex-client](/python-api/grid-cortex-client/overview.md)
- [CortexClient](/python-api/grid-cortex-client/cortexclient.md)