Claude Code

curl -fsSL https://plugin.ashlr.ai/install.sh | bash

Then run these slash commands in Claude Code:

/plugin marketplace add ashlrai/ashlr-plugin
/plugin install ashlr@ashlr-marketplace
/reload-plugins

If /reload-plugins is unavailable or the plugin is not visible afterward, fully quit and restart Claude Code.

Verify

Run /ashlr-status in Claude Code. You should see:

ashlr v1.x active — MCP router running

If the status line is missing, run /ashlr-doctor for diagnostics.

Ashlr ships a Codex plugin manifest at .codex-plugin/plugin.json, a Codex MCP manifest at .mcp.json, nudge-first hooks at hooks/codex-hooks.json, Codex skills under skills/, and Codex explorer/worker guidance under .codex/agents/.

git clone https://github.com/ashlrai/ashlr-plugin
cd ashlr-plugin && bun install
codex plugin marketplace add ashlrai/ashlr-plugin
codex plugin add ashlr@ashlr-marketplace
bun run scripts/cli.ts codex-doctor --json

For MCP-only setup, add this to ~/.codex/config.toml:

[mcp_servers.ashlr]
command = "bun"
args = ["run", "/abs/path/to/ashlr-plugin/scripts/ashlr-mcp.ts"]
env = { ASHLR_MCP_HOST = "codex-cli" }

Then run from the checkout:

bun run scripts/cli.ts codex-doctor --json

Cursor

Add to .cursor/mcp.json in your repo (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "ashlr": {
      "command": "bun",
      "args": ["run", "/abs/path/to/ashlr-plugin/scripts/ashlr-mcp.ts"],
      "env": {
        "ASHLR_MCP_HOST": "generic"
      }
    }
  }
}

Restart Cursor after saving. The MCP indicator in the status bar should turn green.

Goose

goose mcp add ashlr bun run /abs/path/to/ashlr-plugin/scripts/ashlr-mcp.ts

Manual install (pin to source)

git clone https://github.com/ashlrai/ashlr-plugin ~/.claude/plugins/cache/ashlr-marketplace/ashlr
cd ~/.claude/plugins/cache/ashlr-marketplace/ashlr && bun install

Then run the same marketplace slash commands shown above.

Requirements

Bun 1.3+ (required — the entrypoint runs via bun). Install: curl -fsSL https://bun.sh/install | bash. Verify: bun --version.
Codex CLI, Claude Code 0.2+, Cursor 0.40+, or Goose 1.x
gh CLI (optional — only needed for ashlr__pr and ashlr__issue)

Uninstall

/plugin uninstall ashlr@ashlr-marketplace

Settings added by /ashlr-allow can be removed with:

bun run ~/.claude/plugins/cache/ashlr-marketplace/ashlr/scripts/install-permissions.ts --remove

Install

On this page