Install for Codex

Codex plugin

Install, review, then move.

Repset bundles trusted-review hooks, an MCP server, a local runtime, and a camera-free fallback. macOS with Node 24 LTS is the primary tested target.

GitHub marketplace release

Release channel status

Install the pinned Repset v0.1.1 marketplace release.

Repset is published from the public GitHub repository with a pinned marketplace reference. Copy the command below, then review the plugin and hooks before installing.

The command uses the current official Codex marketplace syntax and a semantic release tag.

Install from GitHub

Add the repository marketplace and install the plugin from the pinned release.

codex plugin marketplace add AmirmLotfy/repset --ref v0.1.1 && codex plugin add repset@repset-marketplace
  1. Open Codex and run /plugins.
  2. Select the Repset Marketplace, then install Repset.
  3. Review SessionStart and Stop in /hooks.
  4. Start a new Codex task so the skill and MCP tools are loaded.

Codex CLI, desktop, and IDE extension

Codex CLI

Run the copied command above from the repository root, then use /plugins, /hooks, and a new task.

Codex desktop

Open Plugins, add the repository marketplace from the checked-out repository, install Repset, review hooks, and begin a new task.

IDE extension

Use the extension’s plugin marketplace interface to add the checked-out repository, then repeat the same review and new-task sequence.

What will be installed

  • Two non-blocking lifecycle hooks: SessionStart and Stop.
  • A local stdio MCP server with status, break, completion, and Snooze tools.
  • A loopback-only browser experience and bundled pose model assets.
  • A curated local movement catalog and deterministic fallback.

Hooks require review/trust. They invoke bundled scripts with a one-second ceiling, record only sanitized coarse events, and exit successfully if the local service is unavailable.

Verify the installation

  1. Start a new task with REPSET_DEMO_MODE=1.
  2. Finish a turn, then ask: “How is my Repset week going?”
  3. Ask: “Start a 60-second movement break.”
  4. Try standing, seated, honor, camera-denied, and Snooze paths.
  5. Complete one break and ask for status again to see local progress.

Permissions, demo mode, and removal

  • Camera permission is requested only after you choose the camera path.
  • OPENAI_API_KEY is optional, local-only, and never required for the deterministic selector.
  • REPSET_DEMO_MODE=1 makes the next Stop immediately eligible and uses isolated seeded demo data.
  • Remove Repset in Plugins; then remove its plugin data directory after closing Codex if you want to delete local data.

If plugin installation is not available, use the no-login browser judge demo. It exercises the curated movement choices and fallback without changing Codex.