Welcome to Mogplex
Choose the right Mogplex starting point, platform area, capability, configuration path, guide, or reference page.
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.
Documentation index
Fetch the complete docs index at /llms.txt. Use
/llms-full.txt when you need the full text of every docs
page for an agent or external reader.
Start here
Quickstart
Connect GitHub, sync a repo, choose a routing surface, run locally, and inspect the first run.
How Mogplex Fits Together
Understand the object model from account state and routing to missions, tasks, Worktrees, Sandbox compute, runs, and observability.
Control Execution Environments
Choose Sandbox compute or a task Worktree, then use each lifecycle action without changing the other resource.
Common Use Cases
Pick the right Mogplex surface for review, triage, CI, mentions, local work, headless runs, sandboxes, and API usage.
GitHub Routing Cookbook
Use concrete recipes for mentions, PR review, issue triage, CI failure response, scheduled work, and direct run starts.
Troubleshooting
Debug setup, routing, models, CLI auth, sandboxes, API, and observability from the owning surface.
Observability Runbook
Trace failed, stuck, expensive, or noisy work from source surface to run events, tool calls, sandboxes, and API state.
How to Work With Mogplex
Write clearer requests for CLI runs, GitHub mentions, assignments, automations, and headless jobs.
Available Models
Understand the live model catalog, enabled models, defaults, plan access, CLI sync, and repo-level exclusions.
Model Selection and Cost
Choose models across settings, agents, automations, CLI runs, repo exclusions, and cost observability.
Plans & Billing
Coming soon: plan tiers, billing setup, included usage, limits, invoices, and account entitlements.
Support
Find the right troubleshooting path for setup, routing, models, CLI auth, sandboxes, integrations, and docs issues.
Product map
Platform
Understand the app, CLI, headless runs, Projects, Sandbox compute, Worktree checkouts, API, and object model as one platform.
Capabilities
Agents, automations, triggers, assignments, observability, and reusable agent context.
Configure & Extend
Settings, models, billing, GitHub App coverage, skills, MCP, permissions, approvals, and slash commands.
Integrations
Connect Mogplex to GitHub, Vercel, Slack, CI, the hosted API, MCP clients, and local agent hosts.
Guides
Operational walkthroughs for setup, routing, GitHub coverage, CLI configuration, and legacy routes.
Reference
API reference, CLI reference, slash commands, keybindings, cost reporting, and route details.
Core capabilities
Projects
Import repos, organize workspaces, launch sandboxes, and open the repo surface where hosted work begins.
Agents
Define reusable agents with names, slugs, prompts, models, categories, skills, rules, and context.
Agent Authoring
Design durable worker behavior before binding it to Triggers, Assignments, Automations, mentions, or API runs.
Routing
Choose between Triggers, Assignments, and Automations instead of overbuilding the first route.
Review and Triage
Set up PR review, issue triage, CI failure investigation, GitHub mentions, and explicit follow-up edits.
Projects, Sandboxes, and Worktrees
Keep remote compute separate from task-specific Git checkouts, selected bindings, and independent lifecycle actions.
Sandbox Setup Checklist
Configure repo launch settings, root directory, commands, ports, env, branch intent, and preview expectations.
Observability
Trace run health, pressure, sandbox time, model calls, tool calls, tokens, and estimated cost.
Automations
Build multi-step GitHub-triggered workflows with branching, parallel agents, delays, drafts, and publishing.
Configure and extend
Settings
Manage GitHub identity, App coverage, billing access, access tokens, models, shared preferences, and connections.
Available Models
Understand the live model catalog, enabled models, defaults, plan access, CLI sync, and repo-level exclusions.
Installations
Understand GitHub App coverage, repo eligibility, and why visibility is different from triggerability.
Skills
Install and use Mogplex skills that guide users through slash commands, login, and repo-local configuration.
Repo Instructions
Use AGENTS.md, AGENTS.override.md, and agent.json to give Mogplex durable repo-local context.
Custom Slash Commands
Create project or user scoped prompt templates that become reusable CLI composer commands.
External Connections
Configure REST and MCP tools, understand repo scope resolution, and sync cloud MCP servers into the CLI.
MCP
Connect a local agent to Mogplex over Streamable HTTP with OAuth 2.1 + PKCE.
Connect your stack
GitHub App coverage
Confirm the right owner has the App installed, synced, and eligible for webhook-backed work.
GitHub mention routing
Route bare and targeted `@mogplex` mentions through Triggers or Automations without ambiguity.
Slack
Install Mogplex in Slack, link channels to repos, and control Slack-started repo-agent runs.
CI integration
Run Mogplex from GitHub Actions or another CI system and tail structured run events.
Hosted API
Authenticate, list repos, start a run, inspect events, cancel work, and list sandboxes from scripts.
Troubleshooting
Find the owning surface when setup, routing, runtime, sandbox, API, or CLI state looks wrong.
Reference paths
CLI quickstart
Install the CLI, sign in, start a first run, and learn the cockpit commands that matter first.
Slash commands
Browse every `/...` command available in the CLI composer.
CLI reference
Learn panels, drawers, keybindings, cost and usage, and run export behavior.
API reference
Use one complete route for auth, request types, payloads, responses, errors, and every public v1 endpoint.
Security and Data Handling
Understand tokens, secrets, webhooks, run events, sandboxes, and safe support artifacts.
The shortest reliable first-day path
- Open the web app and connect GitHub in Settings.
- Confirm the right user or org has Mogplex GitHub App coverage in Installations.
- Sync repos and open the target repo in Projects.
- Check or create the reusable agents you want in Agents.
- Choose the smallest routing surface that fits the job: Triggers, Assignments, or Automations.
- Install the CLI, run
mogplex, and start a local task in the repo. - Use Observability once work is actually running.
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, Settings, Installations, Mogplex App, or Mogplex CLI, depending on where the setup breaks.