Muse Code Bridge for Codex

# Muse Code Bridge

Call Muse Code from **Codex / ChatGPT desktop**, using your Muse Code subscription or an explicit pay-as-you-go API key. Ask for an independent code review, compare approaches, or delegate an implementation, then continue the same Muse conversation. **Hermes and OpenCode integrations are works in progress and currently untested in those hosts.**

Choose between Muse as a collaborator through MCP tools and skills, or the experimental **combined OpenAI/Muse model picker on macOS**. The [ChatGPT + Muse companion shortcut](docs/shared-gateway-design.md) uses one native task server and a local model gateway. The original ChatGPT icon remains available for ordinary launches. Live provider switching and native tool handoffs have passed; actual mobile Remote behavior and automatic GUI picker refresh remain unverified.

Community integration requiring Muse Code **1.0.3+** and Muse Session Protocol v1. The shared launcher is currently limited to the tested desktop executable, **`codex-cli 0.154.0-alpha.6.2`**. This repository contains no credentials and no hosted relay.

The included skills define two responsibility splits: **`muse-implement`** lets Muse implement and test while the host scopes and verifies; **`muse-review`** lets Muse critique while the host verifies findings and owns fixes. The shared **`muse`** skill supports consultation and session handling. See the [skill catalog, installation, and usage](docs/skills.md).

Codex bundles the complete collection. The work-in-progress Hermes/OpenCode installers accept `--skills implement`, `--skills review`, or `--skills all`. Omit the flag to preserve the previous selection on updates (all on a fresh installation). `--list-skills` lists the catalog without contacting Muse.

## Install

Repository: [danny-hines/muse-code-bridge](https://github.com/danny-hines/muse-code-bridge).

**New here? Share the [quick setup guide](docs/setup.md)**. It includes a one-command install, copy-ready prompts for an agent, and instructions for switching back.

The bootstrap installs MCP tools, skills, dependencies, and the source/bundles needed by the companion shortcut. It does not install the shortcut or activate the combined picker automatically. Legacy provider-replacement commands remain disabled. If an earlier installation hid your models, follow the [recovery instructions](docs/native-provider.md#switching-