will

Will - Session Handoff for Claude Code

A Claude Code plugin that enables session continuity across different Claude instances through structured handoff documents.

What It Does

The Will plugin creates, reads, and manages WILL.md files that capture your current work state, allowing you to seamlessly hand off unfinished work between Claude sessions or instances.

When to Use It

• Switching contexts mid-task - Need to work on something else but want to come back later
• Long-running projects - Work that spans multiple sessions
• Session limits - Approaching context limits and need a fresh start
• Passing work between instances - Different machines or environments
• Saving work state - Preserve current progress before taking a break

Installation

Via cc-marketplace (Recommended)

This plugin is available in the mjbellantoni/cc-marketplace.

Add the marketplace to your Claude Code plugins directory, then enable the will plugin in your project's .claude/settings.json:

{
  "enabledPlugins": {
    "will@mjb-plugins": true
  }
}

Manual Installation

Clone this repository and symlink it to your plugins directory:

git clone https://github.com/mjbellantoni/will-claude.git
mkdir -p ~/.claude/plugins
ln -s /path/to/will-claude ~/.claude/plugins/will

Then enable it in your project's .claude/settings.json:

{
  "enabledPlugins": {
    "will": true
  }
}

Usage

1. Writing Your Will (End Session)

When you need to switch contexts or end a session with unfinished work:

User: "Write your will"

Claude will create WILL.md in your project root containing:

• Original request and goals
• Current status and what's been done
• Next steps to continue
• Key files and context
• Open questions or blockers
• A ready-to-use prompt for resumption

2. Reading the Will (Resume Work)

When starting a new session and WILL.md exists:

User: "Read the will and continue"

Claude will:

1. Load the WILL.md file
2. Verify the codebase state matches
3. Summarize what was done and what's next
4. Ask for confirmation before continuing
5. Resume work from where you left off

3. Cleanup (Work Complete)

When the work is finished and you no longer need the handoff:

User: "Cleanup the will"

Claude will remove WILL.md after confirming the work is complete.

Example Workflow

# Session 1: Start work
User: "Add user authentication to the app"
Claude: [begins implementing auth system]
User: "I need to switch to another task, write your will"
Claude: "Will written to WILL.md - ready for handoff"

# Session 2: Resume work (later or different instance)
User: "Read the will and continue"
Claude: "I see we were adding user authentication. The login component
        is done, next step is to add the JWT middleware. Ready to continue?"
User: "Yes"
Claude: [continues implementation]
User: "Cleanup the will"
Claude: "WILL.md removed - handoff complete"

What's in a WILL.md File?

# Session Handoff

> Written: 2026-02-11 14:30:00
> Original request: Add user authentication to the app

## Current Status

We're implementing JWT-based authentication. Login component is complete,
middleware is next.

## What Was Done

- Created LoginForm component with validation
- Added auth service with login/logout methods
- Set up JWT token storage in localStorage

## Next Steps

1. Create auth middleware to verify JWT tokens
2. Add protected route wrapper component
3. Update API client to include auth headers
4. Add tests for auth flow

## Key Files

- `src/components/LoginForm.tsx` - Login UI component
- `src/services/auth.ts` - Authentication service
- `src/api/client.ts` - Will need auth headers added

## Context & Decisions

- Using JWT tokens stored in localStorage (user preferred over cookies)
- Token refresh not implemented yet (marked as future enhancement)
- Following existing component patterns in src/components/

## Open Questions

- Should we add "remember me" functionality?
- Token expiration time preference?

## Prompt to Continue

"Read the will and continue implementing the auth middleware
as described in Next Steps."

Skills Reference

/will:read

Resume work from WILL.md handoff document.

Trigger phrases:

• "read the will"
• "continue where we left off"
• "pick up the handoff"

/will:write

Create WILL.md for session handoff.

Trigger phrases:

• "write your will"
• "hand this off"
• "I need to switch contexts"

/will:cleanup

Remove WILL.md when work is complete.

Trigger phrases:

• "cleanup the will"
• "we're done"
• "remove the handoff"

Brivlo Integration