gethamster · harveyfullstack · Aug 25, 2026 · Aug 25, 2026 · Aug 25, 2026 · Aug 25, 2026
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -11,7 +11,7 @@
  {
  "name": "hamster",
  "description": "Orchestrates Hamster Studio brief execution with team personas, parallel wave execution, and deep review modes",
- "version": "3.2.0",
+ "version": "3.3.0",
  "source": "./",
  "category": "workflow",
  "homepage": "https://tryhamster.com",

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
@@ -1,13 +1,14 @@
 {
  "name": "hamster",
- "version": "3.2.0",
+ "version": "3.3.0",
  "description": "Orchestrates Hamster Studio brief execution with team personas, parallel wave execution, and deep review modes. Ship, plan, review, QA, and retro — all from Claude Code.",
  "author": {
  "name": "Hamster",
  "url": "https://tryhamster.com"
  },
  "homepage": "https://tryhamster.com",
  "repository": "https://github.com/gethamster/cli",
+ "mcpServers": "./.mcp.json",
  "license": "Proprietary",
  "keywords": [
  "hamster",

diff --git a/.codex-plugin/marketplace.json b/.codex-plugin/marketplace.json
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
@@ -1,13 +1,14 @@
 {
  "name": "hamster",
- "version": "3.2.0",
+ "version": "3.3.0",
  "description": "Orchestrates Hamster Studio brief execution with team personas, parallel wave execution, and deep review modes. Ship, plan, review, QA, and retro.",
  "author": {
  "name": "Hamster",
  "email": "hello@tryhamster.com"
  },
  "homepage": "https://tryhamster.com",
  "repository": "https://github.com/gethamster/cli",
+ "mcpServers": "./.mcp.json",
  "license": "Proprietary",
  "keywords": [
  "hamster",

diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
@@ -6,14 +6,14 @@
  },
  "metadata": {
  "description": "Cursor plugins for Hamster Studio",
- "version": "3.2.0"
+ "version": "3.3.0"
  },
  "plugins": [
  {
  "name": "hamster",
  "source": ".",
  "description": "Orchestrates Hamster Studio brief execution with team personas, parallel wave execution, and deep review modes",
- "version": "3.2.0",
+ "version": "3.3.0",
  "author": {
  "name": "Hamster",
  "email": "hello@tryhamster.com"

diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
@@ -1,13 +1,14 @@
 {
  "name": "hamster",
- "version": "3.2.0",
+ "version": "3.3.0",
  "description": "Orchestrates Hamster Studio brief execution with team personas, parallel wave execution, and deep review modes. Ship, plan, review, QA, and retro.",
  "author": {
  "name": "Hamster",
  "email": "hello@tryhamster.com"
  },
  "homepage": "https://tryhamster.com",
  "repository": "https://github.com/gethamster/cli",
+ "mcpServers": "./.mcp.json",
  "license": "Proprietary",
  "keywords": [
  "hamster",

diff --git a/.mcp.json b/.mcp.json
@@ -0,0 +1,8 @@
+{
+ "mcpServers": {
+ "hamster": {
+ "type": "http",
+ "url": "https://tryhamster.com/mcp"
+ }
+ }
+}
diff --git a/README.md b/README.md
@@ -62,46 +62,34 @@ A [Claude skill](https://docs.anthropic.com/en/docs/claude-code/skills) is also
 
 ---
 
-## hamster — Claude Code Plugin
+## hamster — Claude Code, Cursor, and Codex plugins
 
-This repo also ships a [Claude Code plugin](https://docs.anthropic.com/en/docs/claude-code/plugins) that orchestrates end-to-end execution of Hamster Studio briefs. The plugin is **execution-only**: plans (parent tasks, subtasks, context) are generated upstream in Hamster Studio and synced into `.hamster/` via `hamster sync`. The plugin schedules those existing tasks into parallel waves inline (no planner agent), dispatches independent parent tasks simultaneously, reviews each wave, and creates bisectable commits per parent task. Executors load project context as they go — the `hamster-project-context` skill, project skills, blueprints, and methods — but never generate or elaborate tasks. Trust comes with leeway, not blindness: executors adapt to mechanical drift (a file moved, a helper renamed) and document it, and escalate genuine plan defects as PLAN_ISSUE — verified by the orchestrator, decided by the user when scope is affected, and fed back to Hamster Studio via the PR's Plan Feedback section.
+This repo also ships Hamster plugins for Claude Code, Cursor, and Codex that orchestrate end-to-end execution of Hamster Studio briefs. The plugins are **execution-only**: plans (parent tasks, subtasks, context) are generated upstream in Hamster Studio and synced into `.hamster/` via `hamster sync`. They schedule those existing tasks into parallel waves inline (no planner agent), dispatch independent parent tasks simultaneously, review each wave, and create bisectable commits per parent task. Executors load project context as they go — the `hamster-project-context` skill, project skills, blueprints, and methods — but never generate or elaborate tasks. Trust comes with leeway, not blindness: executors adapt to mechanical drift (a file moved, a helper renamed) and document it, and escalate genuine plan defects as PLAN_ISSUE — verified by the orchestrator, decided by the user when scope is affected, and fed back to Hamster Studio via the PR's Plan Feedback section.
 
 ### Plugin install
 
-In Claude Code:
+Every host package points to the shared root `.mcp.json`, which connects to the hosted Hamster MCP server. On first use, the host discovers OAuth and prompts you to sign in to your Hamster workspace.
+
+#### Claude Code
 
 ```
 /plugin marketplace add gethamster/cli
 /plugin install hamster@hamster-plugins
 ```
 
-### Cursor and Codex plugin packaging
-
-This repository also includes first-class plugin manifests for:
+#### Cursor
 
-- Cursor: `.cursor-plugin/plugin.json` and `.cursor-plugin/marketplace.json`
-- Codex-compatible hosts: `.codex-plugin/plugin.json` and `.codex-plugin/marketplace.json`
+In Cursor, open **Customize** in the sidebar, choose **Plugins**, and import the marketplace from `https://github.com/gethamster/cli`. Find Hamster, select **Install**, and choose project or user scope.
 
-These manifests include listing metadata (`version`, `author`, `homepage`, `repository`, `license`, `keywords`, `category`, `tags`) plus component paths (`agents`, `commands`, `skills`) and a shared logo (`assets/logo.svg`).
+#### Codex
 
-Cursor publish URL:
+Add the repository as a Codex marketplace:
 
 ```bash
-# Submit for review/public listing
-# https://cursor.com/marketplace/publish
+codex plugin marketplace add gethamster/cli
 ```
 
-Codex note:
-
-- OpenAI Codex CLI currently does not document a public plugin marketplace submission endpoint.
-- Use direct repository distribution and consume `.codex-plugin/plugin.json` in your Codex host/runtime integration.
-
-Codex local install helper:
-
-```bash
-./scripts/install-codex-plugin.sh # symlink mode (default)
-./scripts/install-codex-plugin.sh copy # copy mode
-```
+Then open Codex, run `/plugins`, and install `hamster@hamster-plugins`.
 
 ### Plugin skills
 

diff --git a/scripts/install-codex-plugin.sh b/scripts/install-codex-plugin.sh
diff --git a/skills/ask/SKILL.md b/skills/ask/SKILL.md
@@ -1,4 +1,5 @@
 ---
+name: ask
 description: >-
  Ask Hamster to connect the current code or editor context with workspace
  priorities, blockers, blueprints, related work, or intent. Also supports

diff --git a/skills/plan/SKILL.md b/skills/plan/SKILL.md
@@ -1,4 +1,5 @@
 ---
+name: plan
 description: Plan a Hamster Studio brief. Read tasks, build dependency graph, detect parallel execution waves, with optional CEO or Eng review modes. Use when the user wants to analyze a brief before executing.
 ---
 

diff --git a/skills/qa/SKILL.md b/skills/qa/SKILL.md
@@ -1,4 +1,5 @@
 ---
+name: qa
 description: Systematic QA with diff-aware, full suite, quick smoke, or regression testing modes. Issue taxonomy and optional fix loop. Use when the user wants to run tests or check quality on their changes.
 ---
 

diff --git a/skills/resume/SKILL.md b/skills/resume/SKILL.md
@@ -1,4 +1,5 @@
 ---
+name: resume
 description: Resume an interrupted brief execution. Auto-detect progress, reconstruct state from git history and task statuses, and continue from the correct wave. Use when the user wants to continue a previously interrupted ship session.
 ---
 

diff --git a/skills/retro/SKILL.md b/skills/retro/SKILL.md
@@ -1,4 +1,5 @@
 ---
+name: retro
 description: Engineering retrospective from git history. Team metrics, contributor deep-dives, trends, and actionable insights. Use when the user wants a retrospective on recent development activity.
 ---
 

diff --git a/skills/review/SKILL.md b/skills/review/SKILL.md
@@ -1,4 +1,5 @@
 ---
+name: review
 description: Paranoid two-pass code review. CRITICAL issues that block shipping, then INFORMATIONAL advisory findings. Interactive resolution for critical issues. Use when the user wants a code review on their current feature branch.
 ---
 

diff --git a/skills/ship/SKILL.md b/skills/ship/SKILL.md
@@ -1,4 +1,5 @@
 ---
+name: ship
 description: Ship a Hamster Studio brief. Merge base, implement in parallel waves, test, review, create bisectable commits, and optionally PR. Use when the user wants to execute or ship a brief.
 ---