Overview

Mogplex CLI is a terminal-native command center for supervising AI coding runs — agents, runs, MCP, memory, diffs, approvals, cost, and model routing on one screen.

The Mogplex CLI (mogplex) is a terminal-native command center for supervising AI coding runs.

It is not a log viewer. It is the operator cockpit for everything happening on a run: the agents working on it, the timeline of events, the MCP servers in use, the memory being read and written, the diffs being produced, the tool calls waiting for approval, and the cost and tokens being burned.

agents  ·  runs  ·  tools  ·  MCP servers  ·  context  ·  memory
diffs   ·  cost  ·  tokens ·  model routing ·  approval gates  ·  process control

Installation

Quickstart

Concepts

Architecture, transports, permissions modes, approvals, and attach mode.

Reference

Panels, drawers, keybindings, cost & usage, export.

Commands

Slash command reference — every `/...` you can type in the composer.

Guides

Skills

Agent Skills that guide users through the Mogplex cockpit — slash commands, login flow, and repo-local config.

Where the CLI fits

Web app is the shared control plane: GitHub coverage, repo setup, reusable agents, hosted runs, routing, settings.
CLI is the persistent terminal cockpit you sit in front of while a run is happening — start it, watch it, steer it, approve it, kill it.

The CLI consumes structured events from the Mogplex core and sends commands back. It does not spawn Claude Code or Codex directly; it observes and controls runs that core orchestrates.

What the CLI shows

The screen is split into panels you can focus and drawers you can open:

Header — repo, branch, model, mode, run status, dirty flag, permission mode, transport health
Agents — every agent on the active run with status, model, current action
Timeline — structured events streaming in
Context & Memory — what's loaded, what's been written
MCP strip — which MCP servers are ready
Command input — slash commands and composer
Priority alerts — things you should not miss

Drawers cover the deep views: diffs, approvals, MCP detail, memory, agent detail, model picker, cost, run export, and a command palette for everything else.

See Reference → Panels and Reference → Drawers.

What the CLI is best at

Watching a run end-to-end without leaving the terminal.
Approving or rejecting tool calls as they happen.
Switching models, pausing, resuming, killing, exporting a run.
Attaching to an in-flight run that started somewhere else (--attach <runId>).

Files the CLI reads

~/.mogplex/auth.json — Mogplex token and compatibility auth state.
~/.mogplex/permissions.json — global permission mode and rules.
~/.mogplex/projects/<repo-slug>/permissions.json — project-level overrides.
~/.mogplex/logs/ — structured session logs (secrets redacted).

Slash commands at a glance

/run <task>, /pause, /resume, /kill, /agents, /mcp, /diff, /memory, /model, /cost, /export, /help, /clear, /quit (alias /exit).

Full reference: Slash commands.