# Welcome to Mogplex (/)





Mogplex is an agent workbench for software teams. These docs are organized by
how the product is used: platform areas, capabilities, configuration,
integrations, guides, and reference.

The web app, CLI, hosted API, and extension paths are still documented in full,
but they are not the main decision tree. Start from the job you are trying to
finish, then drill into the product surface that owns it.

<Callout title="Documentation index">
  Fetch the complete docs index at [`/llms.txt`](/llms.txt). Use
  [`/llms-full.txt`](/llms-full.txt) when you need the full text of every docs
  page for an agent or external reader.
</Callout>

## Start here [#start-here]

<Cards>
  <Card title="Quickstart" href="/quickstart" description="Connect GitHub, sync a repo, choose a routing surface, run locally, and inspect the first run." />

  <Card title="How Mogplex Fits Together" href="/platform/how-mogplex-fits-together" description="Understand the object model from account state and GitHub coverage to repos, routes, runs, sandboxes, and observability." />

  <Card title="Common Use Cases" href="/guides/common-use-cases" description="Pick the right Mogplex surface for review, triage, CI, mentions, local work, headless runs, sandboxes, and API usage." />

  <Card title="GitHub Routing Cookbook" href="/guides/github-routing-cookbook" description="Use concrete recipes for mentions, PR review, issue triage, CI failure response, scheduled work, and direct run starts." />

  <Card title="Troubleshooting" href="/guides/troubleshooting" description="Debug setup, routing, models, CLI auth, sandboxes, API, and observability from the owning surface." />

  <Card title="Observability Runbook" href="/guides/observability-runbook" description="Trace failed, stuck, expensive, or noisy work from source surface to run events, tool calls, sandboxes, and API state." />

  <Card title="How to Work With Mogplex" href="/guides/how-to-work-with-mogplex" description="Write clearer requests for CLI runs, GitHub mentions, assignments, automations, and headless jobs." />

  <Card title="Available Models" href="/web/models" description="Understand the live model catalog, enabled models, defaults, plan access, CLI sync, and repo-level exclusions." />

  <Card title="Model Selection and Cost" href="/guides/model-selection-and-cost" description="Choose models across settings, agents, automations, CLI runs, repo exclusions, and cost observability." />

  <Card title="Plans & Billing" href="/plans-and-billing" description="Coming soon: plan tiers, billing setup, included usage, limits, invoices, and account entitlements." />

  <Card title="Support" href="/support" description="Find the right troubleshooting path for setup, routing, models, CLI auth, sandboxes, integrations, and docs issues." />
</Cards>

## Product map [#product-map]

<Cards>
  <Card title="Platform" href="/platform" description="Understand the app, CLI, headless runs, projects, sandboxes, API, and object model as one connected platform." />

  <Card title="Capabilities" href="/capabilities" description="Agents, automations, triggers, assignments, observability, and reusable agent context." />

  <Card title="Configure & Extend" href="/configure-and-extend" description="Settings, models, billing, GitHub App coverage, skills, MCP, permissions, approvals, and slash commands." />

  <Card title="Integrations" href="/integrations" description="Connect Mogplex to GitHub, Vercel, Slack, CI, the hosted API, MCP clients, and local agent hosts." />

  <Card title="Guides" href="/guides" description="Operational walkthroughs for setup, routing, GitHub coverage, CLI configuration, and legacy routes." />

  <Card title="Reference" href="/reference" description="API reference, CLI reference, slash commands, keybindings, cost reporting, and route details." />
</Cards>

## Core capabilities [#core-capabilities]

<Cards>
  <Card title="Projects" href="/web/spaces" description="Import repos, organize workspaces, launch sandboxes, and open the repo surface where hosted work begins." />

  <Card title="Agents" href="/capabilities/agents" description="Define reusable agents with names, slugs, prompts, models, categories, skills, rules, and context." />

  <Card title="Agent Authoring" href="/configure-and-extend/agent-authoring" description="Design durable worker behavior before binding it to Triggers, Assignments, Automations, mentions, or API runs." />

  <Card title="Routing" href="/capabilities/routing" description="Choose between Triggers, Assignments, and Automations instead of overbuilding the first route." />

  <Card title="Review and Triage" href="/capabilities/review-and-triage" description="Set up PR review, issue triage, CI failure investigation, GitHub mentions, and explicit follow-up edits." />

  <Card title="Sandboxes" href="/platform/projects-and-sandboxes" description="Inspect live and pending preview runtimes across repos, open pinned workspaces, and clean up stale sandboxes." />

  <Card title="Sandbox Setup Checklist" href="/guides/sandbox-setup-checklist" description="Configure repo launch settings, root directory, commands, ports, env, branch intent, and preview expectations." />

  <Card title="Observability" href="/capabilities/observability" description="Trace run health, pressure, sandbox time, model calls, tool calls, tokens, and estimated cost." />

  <Card title="Automations" href="/web/automations" description="Build multi-step GitHub-triggered workflows with branching, parallel agents, delays, drafts, and publishing." />
</Cards>

## Configure and extend [#configure-and-extend]

<Cards>
  <Card title="Settings" href="/web/settings" description="Manage GitHub identity, App coverage, billing access, access tokens, models, shared preferences, and connections." />

  <Card title="Available Models" href="/web/models" description="Understand the live model catalog, enabled models, defaults, plan access, CLI sync, and repo-level exclusions." />

  <Card title="Installations" href="/web/installations" description="Understand GitHub App coverage, repo eligibility, and why visibility is different from triggerability." />

  <Card title="Skills" href="/cli/skills" description="Install and use Mogplex skills that guide users through slash commands, login, and repo-local configuration." />

  <Card title="Repo Instructions" href="/configure-and-extend/repo-instructions" description="Use AGENTS.md, AGENTS.override.md, and agent.json to give Mogplex durable repo-local context." />

  <Card title="Custom Slash Commands" href="/configure-and-extend/custom-slash-commands" description="Create project or user scoped prompt templates that become reusable CLI composer commands." />

  <Card title="Connections and MCP" href="/configure-and-extend/connections-and-mcp" description="Configure REST and MCP tools, understand repo scope resolution, and sync cloud MCP servers into the CLI." />

  <Card title="MCP" href="/extend/mcp-server" description="Understand the planned outbound Mogplex MCP server path for external MCP-aware agent hosts." />
</Cards>

## Connect your stack [#connect-your-stack]

<Cards>
  <Card title="GitHub App coverage" href="/web/guides/github-app-coverage" description="Confirm the right owner has the App installed, synced, and eligible for webhook-backed work." />

  <Card title="GitHub mention routing" href="/web/guides/github-mention-routing" description="Route bare and targeted `@mogplex` mentions through Triggers or Automations without ambiguity." />

  <Card title="Slack" href="/integrations/slack" description="Install Mogplex in Slack, link channels to repos, and control Slack-started repo-agent runs." />

  <Card title="CI integration" href="/cli/automation/ci-integration" description="Run Mogplex from GitHub Actions or another CI system and tail structured run events." />

  <Card title="Hosted API" href="/web/api/quickstart" description="Authenticate, list repos, start a run, inspect events, cancel work, and list sandboxes from scripts." />

  <Card title="Troubleshooting" href="/guides/troubleshooting" description="Find the owning surface when setup, routing, runtime, sandbox, API, or CLI state looks wrong." />
</Cards>

## Reference paths [#reference-paths]

<Cards>
  <Card title="CLI quickstart" href="/cli/quickstart" description="Install the CLI, sign in, start a first run, and learn the cockpit commands that matter first." />

  <Card title="Slash commands" href="/cli/commands" description="Browse every `/...` command available in the CLI composer." />

  <Card title="CLI reference" href="/cli/reference" description="Learn panels, drawers, keybindings, cost and usage, and run export behavior." />

  <Card title="API reference" href="/web/api" description="Start with auth, errors, models, runs, repos, sandboxes, MCP, working requests, and route families." />

  <Card title="Security and Data Handling" href="/reference/security-and-data-handling" description="Understand tokens, secrets, webhooks, run events, sandboxes, and safe support artifacts." />
</Cards>

## The shortest reliable first-day path [#the-shortest-reliable-first-day-path]

1. Open the [web app](/web) and connect GitHub in [Settings](/web/settings).
2. Confirm the right user or org has Mogplex GitHub App coverage in
   [Installations](/web/installations).
3. Sync repos and open the target repo in [Projects](/web/spaces).
4. Check or create the reusable agents you want in [Agents](/web/agents).
5. Choose the smallest routing surface that fits the job:
   [Triggers](/web/triggers), [Assignments](/web/assignments), or
   [Automations](/web/automations).
6. Install the [CLI](/cli/installation), run `mogplex`, and start a local task
   in the repo.
7. Use [Observability](/web/observability) once work is actually running.

## What working should mean [#what-working-should-mean]

After the first hour, these should all be true:

* Mogplex can see the repos you expect.
* The repo owner has GitHub App coverage, not only OAuth visibility.
* At least one reusable agent is configured the way you expect.
* One local CLI run completes successfully.
* You know whether the next job belongs in Triggers, Assignments, or
  Automations.

If one is still false, start with the [Quickstart](/quickstart),
[Settings](/web/settings), [Installations](/web/installations),
[Mogplex App](/web), or [Mogplex CLI](/cli), depending on where the setup
breaks.