Codex plugin

Install, review, then move.

Repset bundles trusted-review hooks, an interactive MCP App card, a local runtime, and a complete text fallback. macOS with Node 24 LTS is the primary tested target.

GitHub marketplace release

Release channel status

Install the pinned Repset `v0.3.3` 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.

View source on GitHub View v0.3.3 release

Install from GitHub

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

codex plugin marketplace add AmirmLotfy/repset --ref v0.3.3 && codex plugin add repset@repset-marketplace

Open Codex and run /plugins.
Select the Repset Marketplace, then install Repset.
Review SessionStart and Stop in /hooks.
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, Skip, Snooze, and Sandbox demo tools.
A bundled interactive card for real local progress and movement choices in compatible Codex hosts, with skippable first-run setup, persistent local settings, in-Codex standing/seated/honor challenges, and structured text fallback.
An authenticated loopback camera verifier and bundled pose model assets. The browser is not needed for camera-free challenges.
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.

Optional: add floating Pip

Pip can also follow Codex task status.

Install Repset’s original custom pet through Codex’s official review flow. Floating Pip shows Running, Needs input, Ready, and Blocked states; it does not read project content or replace the Repset movement card.

Meet floating Pip

Verify the installation

Start a new task with REPSET_DEMO_MODE=1.
Finish a turn, then ask: “Show my Repset movement card.”
Complete or skip the one-minute local setup, then open Settings to verify duration, nudge, sound, motion, and Pip controls.
Ask: “Start a 60-second movement break.”
Complete standing, seated, or honor mode inside Codex. Then try the explicit camera path and camera-denied recovery.
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, available only to the local runtime or server, and never required for the deterministic selector. It is never shipped to the browser.
REPSET_DEMO_MODE=1 makes the next Stop immediately eligible and uses isolated seeded demo data.
REPSET_DESKTOP_NOTIFICATIONS=1 optionally enables a fixed-copy OS notification for due breaks. It is off by default, contains no project data, and never opens a challenge automatically.
Desktop notices can also be enabled explicitly in Repset Settings. Sound cues are muted by default and synthesized locally only after user interaction.
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.

Read the Privacy policy, Terms, or Support and troubleshooting.