{
  "markdown": "# HandoffKit Plugin for Claude Code\n\nPush AI session handoffs directly to [HandoffKit](https://handoffkit.com) from Claude Code. No more copy-pasting between your terminal and the browser.\n\n## What it does\n\nThis plugin provides a one-command setup (`/handoffkit:setup`) that connects your Claude Code project to HandoffKit via MCP. Once connected, you gain a `push-handoff` tool that sends session handoff messages to HandoffKit as new cells.\n\n- **One-time setup per project** — run `/handoffkit:setup`, paste a token, done\n- **Per-project scoping** — each project directory links to its own HandoffKit project\n- **Secure** — API keys stored by Claude Code, not in project files\n- **Non-blocking** — if the push fails, your handoff is still complete locally\n\n## Setup\n\nIn Claude Code, add the marketplace and install the plugin:\n\n```\n/plugin marketplace add Norsninja/handoffkit-plugin\n/plugin install handoffkit@norsninja\n```\n\nThen link a project:\n\n1. Go to [handoffkit.com/settings](https://handoffkit.com/settings) → **Plugin Integration** → **Generate Token**\n2. Select the project you want to link\n3. Copy the token (starts with `hk_setup_`, expires in 10 minutes)\n4. In Claude Code, in your project directory, run `/handoffkit:setup`\n5. Paste the token when prompted\n\nThat's it. Restart Claude Code and the `push-handoff` MCP tool is available.\n\nIf your project has a legacy `.handoffkit.json` (with an `api_key` field) from an earlier prototype, `/handoffkit:setup` detects it automatically, migrates the file to a credential-free marker, updates your `/handoff` command, and revokes the old key on the server.\n\n## How it works\n\nThe setup skill exchanges your one-time token for a project-scoped API key, then runs `claude mcp add --scope local` to create a per-project MCP connection to HandoffKit's remote server at `handoffkit.com/api/mcp`. After setup, the plugin itself is optional — the MCP connection persists independently.\n\n## Usage\n\nAfter setup, you can:\n- Add a push step to your `/handoff` command to auto-sync chat messages\n- Ask Claude to \"push this to HandoffKit\" anytime\n- The `push-handoff` tool sends only the concise chat message, never full handoff files\n\n## Multiple projects\n\nRun `/handoffkit:setup` in each project directory with a token generated for that HandoffKit project. Each directory gets its own isolated connection.\n\n## Security\n\n- Setup tokens expire in 10 minutes and are single-use\n- API keys are project-scoped — can't access other projects\n- Keys are stored by Claude Code in `~/.claude.json`, not in project files\n- Revoke keys anytime at handoffkit.com/settings\n- All communication is HTTPS\n\n## Requirements\n\n- A [HandoffKit](https://handoffkit.com) account (free tier works)\n- Claude Code with MCP support\n- `curl` available in your shell\n\n## Links\n\n- [HandoffKit](https://handoffkit.com)\n- [Setup Guide](https://handoffkit.com/guides/plugin-setup)\n- [Handoff Template](https://handoffkit.com/guides/handoff-template)\n",
  "bytes": 2966,
  "sha": "78c60514f0f47b1fb8f5d43743a605245b29ac3b7431582ccfceda66fb6f9a44",
  "repo_slug": "norsninja/handoffkit-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_norsninja_handoffkit_plugin_handoffkit_44b0ab68/readme"
}