# docket

Local task tracker shared across Claude Code, Codex, and other agents. Groups items by git repository and provides a local browser dashboard.

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

## What it does

The server acts as a shared backlog that any supported coding agent writes to mid-prompt. Each task assigns itself to a workspace by reading the current git remote. Items created outside a versioned folder drop straight into an Unfiled bucket.

When an agent connects, Docket launches a local browser view at `http://localhost:8787` with workspace counters and task history. Cards accept an optional `sourceUrl` linking directly to an external pull request or issue tracker.

Node.js 18+ is required on the machine. Upgrading to release 3.0 converts the data file to format v8. Rolling back to 2.3.1 without running `docket restore --from-v7` will silently discard the newer fields during subsequent writes.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add docket -- npx -y @pasichdev/docket
```

### Codex

**Platform CLI**
```bash
codex mcp add docket -- npx -y @pasichdev/docket
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "docket": {
            "command": "npx",
            "args": [
                "-y",
                "@pasichdev/docket"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "docket": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@pasichdev/docket"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add docket npx -y @pasichdev/docket
```

## When to use it
- capture quick notes before creating formal tickets
- share one backlog across different coding agents
- isolate pending tasks by repository git remote
- inspect and update items via a local browser view

## Example prompts
- Add a todo item to update API endpoint validations
- List all pending tasks for this workspace
- Mark task 2 as completed and attach the PR link

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22082
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9623
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2071

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