Codex Plugin

Jaunt's Codex plugin packages five CLI-backed skills and two hooks. It does not run an MCP server or app connector. Version 1.1.0 is distributed from this repository's .agents/plugins/marketplace.json.

Install

uvx jaunt install-codex-plugin
# from this clone:
uv run jaunt install-codex-plugin --local --root .

The default command runs these steps in order:

codex plugin marketplace add creatorrr/jaunt
codex plugin add jaunt@jaunt-codex-plugins

Local mode verifies .agents/plugins/marketplace.json, adds the clone root as the marketplace, and installs the same plugin reference. On a rerun, Git mode upgrades the marketplace snapshot. Since Codex has no plugin-update command, the installer re-adds the plugin to refresh its cache. Current Codex releases refresh in place; if an older CLI reports an already-installed error, the installer removes and re-adds it. Local mode performs the same refresh without a Git upgrade.

Start a new Codex session after installation. Open /hooks to inspect and trust the bundled hook definitions; changed hooks require review again.

The bundled command hooks require Bash (macOS, Linux, or a Windows environment that provides Bash).

Skills

• $jaunt:working-with-jaunt loads when work touches Jaunt specs, config, or generated artifacts.
• $jaunt:build resolves the workspace, previews likely model calls, builds, reports actual cost, and runs the gates.
• $jaunt:doctor checks Python and TypeScript workspace health, including the Node/npm/worker/compiler setup, without building.
• $jaunt:convert converts Python or TypeScript only when explicitly invoked.
• $jaunt:first-build-reviewer runs when explicitly invoked or delegated by the build workflow.

On a first build, the build skill delegates one read-only explorer subagent to the reviewer checklist when delegation is available. Otherwise it checks the same contract-silence risks in the main thread.

Workspace model

Jaunt 1.6.2 lets one jaunt.toml cover several packages. Source and test roots may be literal paths or globs. Each module follows its longest containing root and nearest pyproject.toml; that owner controls generated files, stubs, dependency validation, tests, and contract batteries.

Use jaunt migrate --merge-projects to preview consolidation of older child configs. The command makes no model call and refuses route, digest, fingerprint, or artifact changes.

Freshness

The plugin reports Jaunt's current reasons without fixed price estimates:

The build skill reports the actual cost after the command completes.

Hooks

The SessionStart hook reads cwd from its JSON payload and scans for a bounded set of workspaces, injecting a one-line freshness and orphan summary for each. TypeScript summaries include unbuilt, invalid, and diagnostic state. jaunt status imports discovered spec modules, so trust the SessionStart hook only in workspaces whose Python code you trust.

The PreToolUse hook matches apply_patch. It extracts Add, Update, Delete, and Move paths, resolves them against payload cwd, and checks each path through jaunt guard. Jaunt's approval result becomes a Codex deny, because Codex does not support permissionDecision: "ask" for this event. Existing provenance-headed generated .pyi files are denied too, with a pointer to the corresponding .py spec.

Malformed payloads, missing configuration, missing executables, command failures, and timeouts fail open. A hook is a useful guardrail, not a complete security boundary.

Plugin commands select the runner in this order: a compatible installed jaunt, uv run --no-sync jaunt inside a uv project, then uvx jaunt. The final path keeps JavaScript-only projects independent of a Python project scaffold.

See the official plugin, skill, and hook documentation for the host formats.

Next: Claude Code Plugin.