Marinski

AI Agent Handoff — AI skill for Claude Code

AI community

Transfer context between AI agents/tools.

How to install AI Agent Handoff

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Marinski/ai-agent-handoff and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What AI Agent Handoff does

Transfer context between AI agents/tools. Extracts Claude Code sessions and generates structured markdown hand-offs for OpenCode and other AI tools, preserving intent across token limits and platform switches. Extensible jq/sed filters support multiple AI platforms.

Alternatives in AI

  • Debate — AI Debate Hub - Structured four-way debates between Claude, Sonnet, Gemini, and Codex 2.8k ★
  • Token Monitor — Local-first desktop widget for tracking token usage, costs, and limits across 32+ AI coding tools—including Cl 1.8k ★
  • LongHorizon Harness — The long-horizon computer-use harness 1.3k ★

README

ai-agent-handoff

A tool for transferring conversation context and state between different AI agents/tools. Enables seamless handoffs from one AI assistant to another, preserving user intent and allowing you to continue conversations across different platforms or when token limits are reached.

Problem it solves

AI assistants typically have limited context windows and token budgets. When you reach these limits, you lose the conversation history, forcing you to restart from scratch. Additionally, different tools have different capabilities, interfaces, and strengths - you may want to switch between them while preserving the discussion state.

This tool bridges that gap by extracting the substantive parts of an AI coding session and formatting it as a structured handoff document that the next agent — Claude Code, OpenCode, or another tool — can pick up and continue from.

Supported tools

Tool Session store
claude JSONL files under ~/.claude/projects/**/.jsonl
opencode SQLite database at ~/.local/share/opencode/opencode.db (session/message/part tables)
vscode SQLite database at ~/.vscode-server/data/User/globalStorage/github.copilot-chat/session-store.db (sessions/turns tables) — VS Code's native Chat panel, regardless of which model answered (GitHub Copilot, or a BYOK provider extension routed through the same store)

Handoffs work in either direction: `--from claude --to opencode` and `--from opencode --to claude` both work, since `--from` is what selects the extraction backend — `--to` only labels the output for the next agent.

Features

  • Extract user messages from the source tool's session store
  • Extract assistant messages while filtering out that tool's own UI/tool noise (task notifications, local commands, tool metadata)
  • Generate structured markdown hando