> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.usepassport.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.usepassport.ai/_mcp/server.

# View the terminal dashboard

The terminal dashboard is a live, interactive view of your daemon's status, proxied traffic, and certificate grants, running directly in your terminal.

## Open the dashboard

Run `passport` to open it:

```bash showLineNumbers={false}
passport
```

You can customize the display using options such as `--theme`, `--no-animation`, and `--ascii`. For all display options, see [Options](/passport/reference/passport-cli/overview/#options).

## Review the dashboard

The terminal dashboard displays the following sections:

**Status bar** — Shows the CLI version, whether the daemon is online, a certificate warning (for example, a prompt to run `passport setup` if no certificate is provisioned), network and VPN status, the signed-in identity, and the current request count.

**Activity graph** — A graph of daemon (`dmn`) and CLI (`cli`) request activity over time, including proxied, bypassed, and denied counts, success and failure counts, and the peak rate.

**Summary** — Tunnel count, bytes proxied, requests handled, requests rejected, and daemon uptime.

**Traffic by host** and **Traffic by app** — Panels showing request counts grouped by destination host and by the mechanism that routed the request (`daemon` for traffic routed through the local daemon, versus a direct `passport request` call).

**Grants** — The secret references encoded in your current certificate, each shown with its secret store provider and the endpoint it's scoped to.

**Failed secrets** — Any secret resolution failures.

**System** — Connection and identity details: certificate validity countdown (with the `r` shortcut to renew), proxy connection status and upstream host, the daemon's traffic-handling mode (cycles through `permissive`, `strict`, and `allow-all`), and the daemon's process ID.

**Errors** — Recent error messages, if any.

**Connection log** — A live table of recent proxied connections:

| Column      | Description                                                                              |
| ----------- | ---------------------------------------------------------------------------------------- |
| **Time**    | Timestamp of the connection.                                                             |
| **From**    | Whether the connection came through the daemon (`dmn`) or directly from the CLI (`cli`). |
| **Action**  | The action taken for the connection, for example `PROXY`.                                |
| **URL**     | The request URL, for example `CONN postman-echo.com` for a proxied CONNECT tunnel.       |
| **App**     | The client application that made the request, when identified. Shows `-` otherwise.      |
| **OK**      | Whether the request succeeded.                                                           |
| **Latency** | Request latency.                                                                         |

## Keyboard shortcuts

Use the following keyboard shortcuts to interact with the terminal dashboard:

| Key       | Action                                                                           |
| --------- | -------------------------------------------------------------------------------- |
| `s`       | Start or stop the daemon.                                                        |
| `r`       | Force-renew the client certificate.                                              |
| `m`       | Cycle the daemon's traffic-handling mode: `permissive` → `strict` → `allow-all`. |
| `a`       | Add a host to the allowlist.                                                     |
| `x`       | Remove a host from the allowlist.                                                |
| `w`       | Cycle the time window: `1m` → `5m` → `15m` → `30m`.                              |
| `p`       | Toggle the proxy-only filter (hide direct connections and denials).              |
| `T`       | Cycle the color theme.                                                           |
| `↑` / `↓` | Scroll the connection log.                                                       |
| `?`       | Toggle the help screen.                                                          |
| `q`       | Quit the terminal dashboard.                                                     |