# Quickstart (/cli/quickstart)





The shortest useful loop:

1. install the binary
2. start `mogplex`
3. sign in (in-app)
4. start a run with `/run`
5. watch agents and timeline; approve or kill as needed

## 1. Install [#1-install]

See [Installation](/cli/installation).

## 2. Start the cockpit [#2-start-the-cockpit]

```bash
mogplex
```

If you are not authenticated, the in-app login screen appears. Pick one:

* **Sign in with Mogplex** — opens a browser for account-backed login. This
  reuses your plan-backed model access, synced model catalog, and remote MCP
  definitions.

Stored credentials live in `~/.mogplex/auth.json` (file mode `0600`).

<Callout>
  The CLI ships to end users — auth and config are in-app. Environment
  variables exist as escape hatches only. See
  [Configuration and Flags](/cli/guides/configuration-and-flags).
</Callout>

## 3. Start a run [#3-start-a-run]

In the composer:

```text
/run review the staged diff for regressions
```

The Agents panel populates as core spawns workers. The Timeline streams structured events. The Header shows model, mode, run status, and transport health.

## 4. Drive the run [#4-drive-the-run]

| Action              | Command                        |
| ------------------- | ------------------------------ |
| Pause / resume      | `/pause` then `/resume`        |
| Kill the run        | `/kill`                        |
| Switch models       | `/model` (opens picker drawer) |
| Open the diff       | `/diff`                        |
| See cost so far     | `/cost`                        |
| Open MCP detail     | `/mcp`                         |
| Inspect memory      | `/memory`                      |
| Export the run      | `/export`                      |
| List slash commands | `/help`                        |
| Quit                | `/quit` (alias `/exit`)        |

Full reference: [Commands](/cli/commands).

## 5. Approvals [#5-approvals]

If the active permission mode is `approval` (the default), tool calls that touch the workspace pause and surface in the Approval drawer. Approve or reject inline. See [Concepts → Approvals](/cli/concepts/approvals) and [Concepts → Permissions](/cli/concepts/permissions).

## 6. Attach to an in-flight run [#6-attach-to-an-in-flight-run]

If a run was started somewhere else (web app, CI, another shell), you can pull up its cockpit with:

```bash
mogplex --attach <runId>
```

See [Concepts → Attach](/cli/concepts/attach).

## What "working" looks like [#what-working-looks-like]

* `mogplex` opens cleanly to the cockpit (or to the login screen on first run).
* Header shows `transport: nominal` once core is connected.
* `/run <task>` produces agents in the Agents panel and events in the Timeline.
* Approvals appear in the Approval drawer when the run touches the workspace.
* Ctrl+C does **not** quit — it logs a soft-interrupt. Press it twice within 1500ms (or type `/quit`) to exit.

## Common first-run issues [#common-first-run-issues]

* Login succeeds but no models available — check [Available Models](/web/models)
  and the account plan. Account-backed login inherits managed hosted access.
* Header says `transport: offline` — core is unreachable. Check network and retry; the daemon transport surfaces a reconnect banner.
* A slash command "doesn't work" — check `/help` for the actual registry.

## Read next [#read-next]

* [Concepts → Architecture](/cli/concepts/architecture) for the mental model.
* [Concepts → Permissions](/cli/concepts/permissions) for `approval` vs `auto` modes.
* [Reference → Keybindings](/cli/reference/keybindings) for focus rotation and exit behavior.
* [Guides → Authentication](/cli/guides/authentication) for credential precedence.