claude-handoff
Auto-generate handoff prompts and restart Claude Code with fresh context
Open source Open in the app JSON README (API)
About
Auto-generate handoff prompts and restart Claude Code with fresh context
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- amu815
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-04-03T05:35:20Z
- Repository state
- ativo
- Language
- Shell
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
amu815/claude-handoff/claude-handoff
README
# claude-handoff
Claude Codeのコンテキストが長くなったとき、引き継ぎプロンプトを生成して新セッションに移行するプラグイン。
## Requirements
- Claude Code CLI
- Python 3 (used for JSON escaping in hooks)
## Install
```bash
claude plugin install claude-handoff
```
`not found` になる場合は、マーケットプレイスを手動で追加してください：
```bash
claude plugin marketplace add https://github.com/amu815/claude-handoff.git
claude plugin install claude-handoff
```
## Usage
### `/handoff` — 引き継ぎして新セッション起動
1. 現在のタスク状況・変更ファイル・プランを収集
2. セッションサマリを自動生成
3. 追加メッセージを入力（任意）
4. `~/.claude/handoffs/` に引き継ぎファイルを保存
5. `claude update` を実行
6. ユーザーが以下のコマンドで新セッションを起動
7. SessionStartフックが引き継ぎコンテキストを自動注入 → Claudeがすぐに作業再開
```
あなた: /handoff
Claude: (タスク・変更ファイル・サマリを収集)
Claude: 引き継ぎに追加したいメッセージはありますか？
あなた: 次はテストを書いてほしい
Claude: 引き継ぎファイルを保存しました。新しいセッションを開始してください：
claude "前回の引き継ぎを確認して、作業を再開してください"
あなた: (セッション終了後) claude "前回の引き継ぎを確認して、作業を再開してください"
新セッション: (引き継ぎコンテキスト自動注入 → 即座に作業再開！)
```
### 新セッションの起動
`/handoff` 完了後、Claudeが以下のコマンドを案内します：
```bash
claude "前回の引き継ぎを確認して、作業を再開してください"
```
`claude "プロンプト"` で位置引数としてプロンプトを渡せるため、SessionStartフックによるコンテキスト注入と合わせて、新セッションが開いた瞬間にClaudeが作業を再開します。
`claude` だけで起動した場合は、ユーザーが最初のメッセージを入力するまで待機します。
### Stop Hook（セーフティネット）
セッション終了時に未完了タスクや大きな変更があれば `/handoff` を提案します。
## Handoff Files
引き継ぎファイルは `~/.claude/handoffs/` にタイムスタンプ付きで保存されます。
新セッション起動時、**10分以内**のファイルのみ自動読み込みされます（古い引き継ぎが不意に注入されるのを防ぎます）。