hamster-plugins

Hamster CLI

Sync project context from Hamster Studio to your local repositories. Briefs, tasks, blueprints, and methods land in a .hamster/ directory, ready for your editor and AI tools.

Install

curl -fsSL https://tryhamster.com/cli/install | bash

Or download a binary directly from the latest release.

Supported platforms

OS	Architecture
macOS	Intel (amd64), Apple Silicon (arm64)
Linux	amd64, arm64
Windows	amd64

Quick start

# Authenticate with Hamster Studio
hamster auth login

# Initialize a repository
hamster init

# Sync project context
hamster sync

# Or watch for real-time updates
hamster sync --watch

Commands

Command	Description
hamster auth login	Authenticate via browser (OAuth 2.1 + PKCE)
hamster auth logout	Log out and clear stored credentials
hamster init	Initialize .hamster/ directory and run first sync
hamster sync	One-time sync from Hamster Studio
hamster sync --watch	Continuous real-time sync via WebSocket
hamster status	Show sync status and statistics
hamster task status <id> <status>	Update task status (todo, in_progress, done)
hamster brief status <slug> <status>	Update brief status
hamster tui	Launch Mission Control terminal dashboard

What gets synced

.hamster/
  briefs/        # Project briefs
  tasks/         # Task summaries and notes
  blueprints/    # Architecture documents
  methods/       # Team conventions

A Claude skill is also generated at .claude/skills/hamster-project-context/ for automatic project context awareness.

---

hamster — Claude Code Plugin

This repo also ships a Claude Code plugin that orchestrates end-to-end execution of Hamster Studio briefs. It reads briefs and tasks from .hamster/, plans parallel execution waves, dispatches independent parent tasks simultaneously, reviews and simplifies code, and manages git operations with commits after each parent task.

Plugin install

In Claude Code:

/plugin marketplace add gethamster/cli
/plugin install hamster@gethamster-cli

Cursor and Codex plugin packaging

This repository also includes first-class plugin manifests for:

• Cursor: .cursor-plugin/plugin.json and .cursor-plugin/marketplace.json
• Codex-compatible hosts: .codex-plugin/plugin.json and .codex-plugin/marketplace.json

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).

Cursor publish URL:

# Submit for review/public listing
# https://cursor.com/marketplace/publish

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:

./scripts/install-codex-plugin.sh        # symlink mode (default)
./scripts/install-codex-plugin.sh copy   # copy mode

Plugin skills

Skill	Persona	Description
/hamster:ship [slug-or-url]	Release Engineer	Ship a brief: merge base, implement in parallel, test, review, bisectable commits, PR
/hamster:plan [slug-or-url]	Tech Lead + CEO/Eng modes	Analyze brief with optional founder or architecture review
/hamster:resume [slug]	—	Resume interrupted execution from where you left off
/hamster:review	Staff Engineer	Paranoid two-pass code review (CRITICAL then INFORMATIONAL)
/hamster:qa [mode]	QA Lead	Systematic testing: diff-aware, full, quick, regression
/hamster:retro [days]	Eng Manager	Engineering retrospective with metrics, trends, team analysis

/hamster:ship

The main orchestrator. Accepts a brief slug, UUID, or Hamster Studio URL:

/hamster:ship user-authentication
/hamster:ship https://tryhamster.com/home/hamster/briefs/2de8d546-50ab-4dbd-a678-579ec8119f60

If no argument is given, presents an interactive picker of actionable briefs.

Flow: Prerequisites check → Brief selection → Analysis (with user confirmation) → Branch creation → Merge base branch → Parallel wave execution (implement → validate → test gate → review → bisectable commits) → Final validation → Ask about PR creation

/hamster:plan

Read-only analysis with optional deep review. Produces the execution plan without making changes.

/hamster:plan api-rate-limiting