Mission Control Install From GitHub
Purpose
Install or repair the Mission Control bridge assets, daemon bootstrap path, and headless runtime without requiring the standalone UI.
The Codex chat agent is not the Mission Control Manager. It is the bridge between the user and the Mission Control Manager.
Use when
- The user says to install Mission Control from GitHub or from the current repo.
- The user wants a headless-only setup.
- The daemon, plugin bundle, or local skills need a repair pass.
One-command workflow
Use exactly one command as the primary install path:
python scripts/mission-control-manage.py install
Only fall back to scripts/install-mission-control-plugin.ps1 or .sh when the user explicitly wants a shell-native wrapper.
Workflow
- Run
scripts/mission-control-manage.py install as the primary workflow.
- Let the unified workflow install Python packages for
apps/server and apps/mcp-server unless the user explicitly asks to skip package setup.
- Let the unified workflow sync the repo-local plugin bundle and Mission Control skills into Codex home.
- Let the unified workflow write or update the managed
mcp_servers."mission-control" Codex config entry.
- Let the unified workflow run headless bootstrap, daemon verification, bridge verification, and Ollama/Codex runner reporting.
- Tell the user to force-quit and reopen Codex and Claude Code before they try to use Mission Control, because plugin and MCP changes are not loaded into already-open app sessions.
- Tell the user that after the reload Codex should show
Mission Control as an available plugin, not only as standalone Mission Control skills.
- Tell the user to approve the project MCP server from
.mcp.json if Claude Code prompts for it after reload.
- If Codex still does not show the plugin after reload, tell the user to rerun
python scripts/mission-control-manage.py update and restart Codex again before falling back to skill-only workarounds.
Mission Control calls
Scripts:
scripts/mission-control-manage.py
scripts/install-mission-control-plugin.ps1
scripts/mission-control-bootstrap.py
scripts/start-mission-control-daemon.ps1
scripts/mission-control-headless-health.ps1
scripts/start-mission-control-mcp.ps1
Endpoints:
GET /api/headless/config
POST /api/headless/autowire
GET /api/headless/health
GET /api/runners/status
User-facing output
- Report install status as
ready, degraded, or failed.
- Show ready runners, unavailable runners, daemon status, MCP status, Ollama readiness, and the next Codex prompt.
- Include the exact install, update, and uninstall one-command invocations.
- Explain how the user should verify that Codex loaded the real plugin and Claude loaded the project MCP server.
- State clearly that the dashboard is optional and not required for setup.
Approval behavior
- Safe probing and local config generation are fine.
- Do not silently install missing external CLIs, model weights, or API credentials.
- Ask before any new dependency or billing-backed tool path would be introduced.
Never do
- Do not require the standalone UI.
- Do not store raw secrets in Mission Control config, logs, or reports.
- Do not pretend API-backed runners are free or already authenticated when they are not.
Never require the standalone UI.
Failure and fallback
- If backend dependencies are missing, say so directly and point to the backend install command.
- If the daemon can start but MCP is not configured, mark the setup degraded instead of pretending it is fully ready.
- If only
dry_run is available, report that honestly and offer the dry-run follow-up prompt.
Example invocation
Install Mission Control from this repo and wire up everything available.
1---2name: mission-control-install-from-github3description: Install or repair Mission Control for headless Codex use from a repo checkout or GitHub clone.4---56# Mission Control Install From GitHub78## Purpose910Install or repair the Mission Control bridge assets, daemon bootstrap path, and headless runtime without requiring the standalone UI.1112The Codex chat agent is not the Mission Control Manager. It is the bridge between the user and the Mission Control Manager.1314## Use when1516- The user says to install Mission Control from GitHub or from the current repo.17- The user wants a headless-only setup.18- The daemon, plugin bundle, or local skills need a repair pass.1920## One-command workflow2122Use exactly one command as the primary install path:2324```text25python scripts/mission-control-manage.py install26```2728Only fall back to `scripts/install-mission-control-plugin.ps1` or `.sh` when the user explicitly wants a shell-native wrapper.2930## Workflow31321. Run `scripts/mission-control-manage.py install` as the primary workflow.332. Let the unified workflow install Python packages for `apps/server` and `apps/mcp-server` unless the user explicitly asks to skip package setup.343. Let the unified workflow sync the repo-local plugin bundle and Mission Control skills into Codex home.354. Let the unified workflow write or update the managed `mcp_servers."mission-control"` Codex config entry.365. Let the unified workflow run headless bootstrap, daemon verification, bridge verification, and Ollama/Codex runner reporting.376. Tell the user to force-quit and reopen Codex and Claude Code before they try to use Mission Control, because plugin and MCP changes are not loaded into already-open app sessions.387. Tell the user that after the reload Codex should show `Mission Control` as an available plugin, not only as standalone Mission Control skills.398. Tell the user to approve the project MCP server from `.mcp.json` if Claude Code prompts for it after reload.409. If Codex still does not show the plugin after reload, tell the user to rerun `python scripts/mission-control-manage.py update` and restart Codex again before falling back to skill-only workarounds.4142## Mission Control calls4344Scripts:45- `scripts/mission-control-manage.py`46- `scripts/install-mission-control-plugin.ps1`47- `scripts/mission-control-bootstrap.py`48- `scripts/start-mission-control-daemon.ps1`49- `scripts/mission-control-headless-health.ps1`50- `scripts/start-mission-control-mcp.ps1`5152Endpoints:53- `GET /api/headless/config`54- `POST /api/headless/autowire`55- `GET /api/headless/health`56- `GET /api/runners/status`5758## User-facing output5960- Report install status as `ready`, `degraded`, or `failed`.61- Show ready runners, unavailable runners, daemon status, MCP status, Ollama readiness, and the next Codex prompt.62- Include the exact install, update, and uninstall one-command invocations.63- Explain how the user should verify that Codex loaded the real plugin and Claude loaded the project MCP server.64- State clearly that the dashboard is optional and not required for setup.6566## Approval behavior6768- Safe probing and local config generation are fine.69- Do not silently install missing external CLIs, model weights, or API credentials.70- Ask before any new dependency or billing-backed tool path would be introduced.7172## Never do7374- Do not require the standalone UI.75- Do not store raw secrets in Mission Control config, logs, or reports.76- Do not pretend API-backed runners are free or already authenticated when they are not.7778Never require the standalone UI.7980## Failure and fallback8182- If backend dependencies are missing, say so directly and point to the backend install command.83- If the daemon can start but MCP is not configured, mark the setup degraded instead of pretending it is fully ready.84- If only `dry_run` is available, report that honestly and offer the dry-run follow-up prompt.8586## Example invocation8788`Install Mission Control from this repo and wire up everything available.`