# Hamster

Hamster connects your agent to briefs, tasks, plans, and workspace knowledge, then helps carry a selected brief through delivery.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: gethamster
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gethamster/plugin
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/hamster

## What it does

Hamster exposes a hosted MCP connection to the workspace. It can find briefs, tasks, plans, and knowledge, relate the current code to project priorities, and start delivery for a chosen brief.

The plugin includes skills for setup, planning, resuming interrupted work, code review, and QA. The plan is synced into the repository and kept on disk; when MCP tools are unavailable, `hamster chat` provides the fallback path. Coding skills need repository and shell access.

In Claude Code, add the server at `https://tryhamster.com/mcp`. The client handles Hamster sign-in, while the `setup` skill can install the CLI, open authentication, and sync the plan. Work does not start automatically when a session begins.

## Requirements
- Remote server: `https://tryhamster.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http hamster https://tryhamster.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hamster --url https://tryhamster.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hamster": {
            "url": "https://tryhamster.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hamster": {
            "type": "http",
            "url": "https://tryhamster.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hamster https://tryhamster.com/mcp
```

## When to use it
- find briefs and tasks linked to the current repository
- sync a workspace plan into the repo
- turn a brief into an execution plan
- resume an interrupted delivery
- run review and QA before shipping

## Example prompts
- Find Hamster briefs and tasks related to this repository.
- Analyze this brief, create a plan, and sync it into the repository.
- Resume the interrupted brief execution, then review the result before delivery.

## Similar
- [breakdown-plan](https://affpapa.org/en/nevibecode/skills/breakdown-plan.md) — skill · 9294 installs
- [Epoch](https://affpapa.org/en/nevibecode/mcp/epoch.md) — MCP server · ★ 8
- [project-artifact](https://affpapa.org/en/nevibecode/skills/project-artifact.md) — skill · 2323 installs
- [gh-issue-sync](https://affpapa.org/en/nevibecode/skills/gh-issue-sync.md) — skill · 23300 installs
- [paseo-handoff](https://affpapa.org/en/nevibecode/skills/paseo-handoff.md) — skill · 4900 installs
- [session-handoff](https://affpapa.org/en/nevibecode/skills/softaworks-session-handoff.md) — skill · 4200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md