# Guides (/guides)



Guides are task-oriented walkthroughs. Use them when the right product area is
known, but the sequence still matters.

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

  <Card title="How to Work With Mogplex" href="/guides/how-to-work-with-mogplex" description="Write clearer CLI prompts, GitHub mentions, assignment instructions, automation specs, and headless run requests." />

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

  <Card title="Sandbox Setup Checklist" href="/guides/sandbox-setup-checklist" description="Configure root directory, commands, ports, env, branch intent, managed access, and preview expectations before debugging runs." />

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

  <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="Troubleshooting" href="/guides/troubleshooting" description="Debug setup, routing, models, CLI auth, sandboxes, API, and observability from the surface that owns the state." />

  <Card title="Project Workflow" href="/web/guides/project-workflow" description="Connect GitHub, confirm App coverage, sync repos, open a workspace, and choose the next surface." />

  <Card title="Choose the Right Routing Surface" href="/web/guides/choose-routing-surface" description="Decide between Triggers, Assignments, and Automations using source of truth, scope, and prerequisites." />

  <Card title="Connection Scope and Overrides" href="/web/guides/connection-scope-and-overrides" description="Understand account, repo, and surface-specific connection behavior." />

  <Card title="GitHub App Coverage" href="/web/guides/github-app-coverage" description="Debug the difference between OAuth repo visibility and GitHub App triggerability." />

  <Card title="GitHub Mention Routing" href="/web/guides/github-mention-routing" description="Route `@mogplex` mentions through the correct hosted routing surface." />

  <Card title="CLI Authentication" href="/cli/guides/authentication" description="Credential resolution, browser login, stored auth, environment overrides, and logout behavior." />

  <Card title="Configuration and Flags" href="/cli/guides/configuration-and-flags" description="CLI flags, environment variables, storage paths, auth escape hatches, and synced MCP behavior." />

  <Card title="Slash Commands" href="/cli/guides/slash-commands" description="Workflows for the slash commands available inside the interactive cockpit." />

  <Card title="Project Commands" href="/cli/guides/project-commands" description="Repo-local command behavior and project permission rules." />

  <Card title="Legacy Routes" href="/web/guides/legacy-routes" description="Map older dashboard routes such as `/flows`, `/library`, and `/primitives` to current surfaces." />
</Cards>