preqstation

preqstation-skill

PREQSTATION worker skill, Claude plugin, and local Claude dispatch runtime.

This repository currently covers four surfaces:

• the core preqstation worker skill
• remote PREQ /mcp setup for Claude Code and Codex, plus a partial Gemini CLI path
• a Claude plugin with setup/status helpers
• an experimental Claude-only dispatch channel runtime for Hand off tests

For existing OpenClaw users, the current production dispatcher still lives in preqstation-openclaw. Keep using that path until the migration guide says otherwise: docs/migrate-openclaw.md. That guide also documents how OpenClaw dispatch and Claude Code dispatch compare after work completes.

Support Status

• worker skill + remote PREQ MCP: stable for Claude Code and Codex
• Gemini CLI worker path: partial and depends on Gemini remote MCP support
• Claude plugin setup helpers: supported for Claude Code
• Claude dispatch channel: experimental
• shell helper mode: fallback
• OpenClaw migration docs: legacy

In this repository, a Hand off test means PREQ prepares an isolated auxiliary worktree on the requested branch and hands execution off to the target engine inside that worktree.

Choose Your Setup

• Claude Code plugin (recommended): docs/install-claude-plugin.md
• Claude Code worker-only mode: docs/install-claude-code.md
• Codex: docs/install-codex-gemini.md
• Gemini CLI (partial): docs/install-codex-gemini.md
• Experimental Claude dispatch channel: docs/install-dispatch-channel.md
• Shell helper fallback: docs/install-shell-helper.md

Project Docs

• Contributing: CONTRIBUTING.md
• Security: SECURITY.md
• Changelog: CHANGELOG.md
• License: LICENSE

Prerequisites

• Claude plugin and dispatch runtime users need Node 18+ on PATH
• Claude plugin users still register the remote PREQ MCP server separately

MCP Surfaces

Server	Transport	Purpose	Required
preqstation	remote HTTP MCP	PREQ task tools and OAuth-backed /mcp access	yes
preq-dispatch-channel	local stdio MCP	experimental Claude-only dispatch runtime bundled by the plugin	optional

Quick Start

Claude Code

Install the plugin:

claude plugin marketplace add https://github.com/sonim1/preqstation-skill
claude plugin install preqstation@preqstation

The plugin already includes the packaged preqstation skill for Claude Code, so you do not need a separate npx skills add ... -a claude-code install unless you intentionally want worker-only mode without the plugin helpers.

Register the remote PREQ MCP server:

claude mcp add --transport http preqstation https://<your-domain>/mcp

Then start Claude and run:

/preqstation:setup

/preqstation:setup verifies the preqstation MCP connection, fetches projects when preq_list_projects is available, lets you choose auto-scan or manual mapping, and saves repo mappings in ~/.preqstation-dispatch/projects.json.

Useful plugin helper commands:

• /preqstation:setup to configure or refresh project path mappings
• /preqstation:update to see the current plugin update command
• /preqstation:help to see the available Claude plugin, dispatch, worker-only, and OpenClaw paths

For worker-only Claude Code mode without the plugin helpers, use docs/install-claude-code.md.

Codex

npx skills add sonim1/preqstation-skill -g -a codex
codex mcp add preqstation --url https://<your-domain>/mcp

Codex uses the worker + remote MCP path only. It does not use the Claude plugin or the Claude dispatch channel.

Gemini CLI

npx skills add sonim1/preqstation-skill -g -a gemini-cli

Gemini CLI support is partial. Use it only if your Gemini environment already supports remote PREQ MCP, otherwise fall back to the shell helper path.

Canonical Claude Commands

Install:

claude plugin marketplace add https://github.com/sonim1/preqstation-skill
claude plugin install preqstation@preqstation

Update:

claude plugin marketplace update preqstation
claude plugin update preqstation@preqstation

Start the experimental Claude dispatch runtime for a Hand off test:

claude --dangerously-skip-permissions --dangerously-load-development-channels plugin:preqstation@preqstation

Debug the dispatch runtime:

PREQSTATION_DEBUG_QUEUE=1 claude --debug mcp --debug-file /tmp/preqstation-dispatch-debug.log --dangerously-skip-permissions --dangerously-load-development-channels plugin:preqstation@preqstation

During the current Claude Channels research preview, do not add --channels plugin:preqstation@preqstation to the dispatch runtime command above.