agent-kit
Portable workflows for coding agents.
Skills, commands, hooks, and configs that survive tool switches.
Your agent session dies. Your work shouldn't. agent-kit ships portable workflows — starting with /handoff + /handoff-resume — that move state between sessions and tools.
Demo
you: refactor auth middleware to use new token store
agent: <40 tool calls, hits a wall>
you: /handoff ← dump state
you: /clear ← wipe context
you: /handoff-resume ← load state, no re-explaining
agent: === RESUMING SESSION ===
Target: refactor auth middleware to new token store
Branch: refactor/auth [MATCH]
Next step: fix assertion in tests/auth/test_login.py:42
[waits]
you: go ← any affirmative: "go", "yes", "continue"
agent: <continues exactly where it stopped>
Same workflow, any tool. /handoff in Claude Code → /clear → switch to Cursor → /handoff-resume. Same .agents/handoff.md, same state.
Install
Claude Code (native — recommended)
/plugin marketplace add egor-xyz/agent-kit
/plugin install agent-kit@egor-xyz
Then invoke as /handoff and /handoff-resume.
Any other tool (one line)
curl -fsSL https://raw.githubusercontent.com/egor-xyz/agent-kit/main/install.sh | sh -s -- agent-kit --cursor
Replace --cursor with any of --codex, --gemini, --copilot, --claude, or --all. Combine flags to install everywhere at once:
curl -fsSL .../install.sh | sh -s -- agent-kit --cursor --codex --gemini --copilot
Browse what's available:
curl -fsSL .../install.sh | sh -s -- --list
In tools without namespacing, the commands are plain /handoff and /handoff-resume.
Install matrix
| Tool | Path | Install command |
|---|
| Claude Code | plugin cache | /plugin install agent-kit@egor-xyz |
| Cursor | ~/.cursor/commands/ | curl … --cursor |
| Codex | ~/.codex/prompts/ | curl … --codex |
| Gemini | ~/.gemini/commands/ | curl … --gemini |
| Copilot | .github/prompts/ | curl … --copilot |
Override target paths with env vars: AGENT_KIT_CURSOR_DIR, AGENT_KIT_CODEX_DIR, AGENT_KIT_GEMINI_DIR, AGENT_KIT_COPILOT_DIR, AGENT_KIT_CLAUDE_DIR.
Updating
Claude Code:
/plugin marketplace update egor-xyz
Then open the plugin manager (/plugin), select agent-kit, choose Update now. The marketplace omits version from the plugin entry, so every commit on main ships as a new version.
Other tools: re-run the install command with --force:
curl -fsSL .../install.sh | sh -s -- agent-kit --cursor --force
Flagship workflow — Session Handoff
work...
│
▼
/handoff ─▶ writes .agents/handoff.md (target, state, files, changes, dead ends, next step)
│
▼
/clear ─▶ fresh context
│
▼
/handoff-resume ─▶ reads .agents/handoff.md, verifies git state, echoes next step, WAITS
│
▼
"go" ─▶ agent continues exactly where the previous session stopped
Canonical schema: docs/handoff-spec.md.
Plugins
| Plugin | Description | Commands | Skills | Tools |
|---|
agent-kit | Portable workflows — starting with session handoff. | /handoff, /handoff-resume | auto-handoff | all |
More workflows coming as additional commands inside the same plugin (or as separate plugins for granular install). Contribute one.
Bundles
Install a bundle:
curl -fsSL .../install.sh | sh -s -- --bundle session-management --all
Why agent-kit
The space is crowded with bag-of-snippets repos. agent-kit is different:
