One installable package that bundles:
- Skill —
thumble-keypad-generator: the full agent workflow for generating, dry-running, installing, and editing Thumble keypad profiles with thethumbleCLI, including thumb-sized control guidance and shareable skin authoring (material JSON or CSS). - MCP server — a local stdio adapter (
thumble-mcp) exposing Thumble Host's revision-safe profile, layout, binding, and runtime operations as typed MCP tools. Note: skin authoring (scaffold/compile/quality/preview, material or CSS) is CLI-only and always runs through the localthumbleCLI.
Works in Codex (CLI, IDE extension, and Codex in the ChatGPT desktop app). Published plugin builds also surface in ChatGPT chat surfaces.
The repository ships a local marketplace at .agents/plugins/marketplace.json.
- Clone this repo and open the ChatGPT desktop app.
- Restart the ChatGPT desktop app so the repo marketplace is discovered.
- Open Plugins in the sidebar → choose the Thumble (repo marketplace) source → install Thumble.
From the CLI you can also register the marketplace explicitly:
codex plugin marketplace add /absolute/path/to/ThumbleAfter installing, invoke the skill with $thumble-keypad-generator (or just ask for a
Thumble keypad). The MCP tools appear as the thumble MCP server.
- Thumble Host running locally for runtime and configuration tools. The bundled
MCP launcher resolves the adapter in this order:
$THUMBLE_MCP_BINARY(absolute path override),/Applications/Thumble Host.app/Contents/MacOS/thumble-mcp(app bundle),thumble-mcponPATH(e.g.cargo install --locked --path Host/crates/thumble-mcp).
thumbleCLI for the skill's full workflow (generate/spec/bindings/skins). Build it from the repo or install it onPATH; the skill documents both.
The MCP adapter ships with input and configuration writes disabled:
press_controlrequires--allow-inputorTHUMBLE_MCP_ALLOW_INPUT=1.- Saving configuration drafts requires
--allow-config-writeorTHUMBLE_MCP_ALLOW_CONFIG_WRITE=1(plus the host-side flag).
Read/inspect tools work without opt-in. See docs/rust-host.md for the full model.
- MCP Apps UI (controller preview/editor surfaces) is experimental in Codex desktop;
enable with
[features] enable_mcp_apps = truein~/.codex/config.toml, then fully restart. Tools remain fully usable as structured output without it. - ChatGPT chat-side connectors require a remote MCP endpoint. Run
thumble-mcp --relay wss://thumble-mcp-gateway.fly.dev/tunneland register the gateway URL in ChatGPT developer mode — seedocs/rust-host.md("Remote MCP connector relay"). - Keeping the bundled skill in sync:
skills/thumble-keypad-generator/SKILL.mdis a copy of the repository rootSKILL.md. Refresh the copy whenever the root skill changes before publishing or shipping a release.