Drev

Drev makes Claude Code sessions portable: share one with a friend or teammate, or resume it yourself on any machine, Mac or PC.

You finish a long debugging session and hand the work to a teammate. Your colleague leaves on vacation mid-feature and someone has to pick it up. You started something on your work PC and want to keep going from your laptop at home. In all three cases, today the actual Claude Code conversation, every step, every dead end, every "ah, that's why", dies the moment the terminal closes. The next person starts from scratch, even if that next person is you.

Drev keeps the conversation alive. The session moves with the work, not the machine.

The bundled Claude Code skill makes the flow feel native: just say "save this session as foo" and Claude runs drev share for you. Native claude --resume continues the receiver's session with full transcript fidelity.

v0. See ARCHITECTURE.md and docs/CORRECTIONS.md. License: MIT.

Demo

Engineer A finishes a debugging session in Claude Code and says "save this as auth-fix". Engineer B, on a different machine and a different OS, runs drev resume auth-fix. Claude Code opens with the full transcript loaded, every path rewritten to B's machine.

Quick start

npm install -g @codeturion/drev
drev init

What you'll see:

$ drev init
Got a Drev repo URL from your team? (paste, or leave empty to create new):
Create private repo at fuat/drev-sessions? [Y/n] Y
✓ Cloning https://github.com/fuat/drev-sessions.git ...
✓ Drev initialized at /home/fuat/.drev/repos/drev-sessions.
✓ Auto-share enabled. Hooks + skill installed.
✓ Added /home/fuat/work/inventory-app to auto-share whitelist.

Two questions, accept the defaults, you're done. You now have a private GitHub repo for sessions, hooks installed for auto-share, the bundled skill so Claude Code understands drev, and the current project on the auto-share whitelist.

Requires Node ≥20, git, and the gh CLI (the wizard uses it). For non-GitHub hosts or offline use, see Reference.

Example: a session end-to-end

You finish a debugging session in ~/work/inventory-app. Inside Claude Code, you say:

save this session as inventory-sync-fix

Claude runs drev share --name inventory-sync-fix for you. Drev redacts secrets, writes the session into your team repo at users/fuat/2026-05-01-inventory-sync-fix/, and pushes to GitHub.

Next morning, your teammate picks it up. From their machine, in their copy of the project:

cd ~/code/inventory-app
drev resume inventory-sync-fix

Drev pulls the latest, rewrites every path from your machine to theirs (including the OS conventions if you're on different platforms), places the JSONL at ~/.claude/projects/<encoded>/<id>.jsonl, and spawns claude --resume <id>. Claude Code opens with the full transcript loaded.

If you forgot to ask Claude to share, the SessionEnd hook would have shared automatically when you closed your session. Either way the receiver flow is identical.

Use it inside Claude Code

The bundled skill teaches Claude to recognize what you mean, so you talk to it naturally:

Sharing, listing, searching, renaming, marking, scrubbing all run inside the active session. Resume is the exception: it has to spawn a fresh claude --resume as a subprocess that takes over the terminal, and Claude's Bash tool doesn't have an interactive TTY to hand over. To resume someone else's session, open a new terminal and run drev resume <name> there.

Use it from the terminal

drev share --name auth-fix          # share the most recent session
drev list                           # see what's available
drev resume auth-fix                # rewrites paths, places file, spawns Claude Code

Drev redacts common secrets (Anthropic, OpenAI, GitHub, AWS, Slack, JWTs, private keys, …) before pushing. Full list in docs/REDACTION.md. For accidents that slip through, drev scrub <name> --confirm rewrites history.

Auto-share

After drev init, sessions whose project is on the whitelist auto-share when they end. The SessionEnd hook in ~/.claude/settings.json fires drev autoshare-sweep, which walks ~/.claude/projects/, picks up anything new in a whitelisted project, and shares it with visibility: team by default.

drev autoshare add                  # whitelist the current project
drev autoshare list                 # show whitelist + current mode
drev autoshare on | private | off   # team / private / disable
drev hooks uninstall                # remove triggers (skill stays)

The current project is whitelisted automatically by drev init. Other projects on the same machine don't auto-share until you opt them in. To skip the whole install, run drev init --no-auto-share.

Heads up: the SessionEnd hook isn't always reliable across Claude Code versions and exit paths. Treat auto-share as best-effort. For sessions you definitely want shared, ask Claude to share explicitly during the conversation ("save this session as foo"). The skill route runs drev share synchronously and you see it succeed before you close the session. Hook reliability is tracked as a known issue in TASKS/T29-fix-sessionend-reliability.md.

Reference

All drev init forms

drev init                                # wizard (default)
drev init <git-url>                      # bring your own repo
drev init <owner>/<name>                 # github shorthand: clone if exists, else create private
drev init --local [--at <path>]          # local bare repo, no GitHub
drev init <anything> --reinit            # repoint an existing setup or reuse a clone
drev init --no-auto-share <X>            # skip hooks, skill, and whitelist install

The wizard sequence:

$ drev init
Got a Drev repo URL from your team? (paste, or leave empty to create new):
Create private repo at fuat/drev-sessions? [Y/n] Y
✓ Drev initialized at /home/fuat/.drev/repos/drev-sessions
✓ Auto-share enabled. Hooks + skill installed.

All commands

Each command supports --help for the full option list.

Non-GitHub hosts (GitLab, Bitbucket, self-hosted)

Auto-create only knows GitHub. For other hosts, pre-create the repo on the host's UI or CLI, then init with the URL:

# GitLab
glab repo create team/sessions --private
drev init https://gitlab.com/team/sessions.git

# Bitbucket
drev init https://bitbucket.org/team/sessions.git

# Self-hosted (Gitea, Forgejo, GitLab CE, …)
drev init https://git.company.internal/team/sessions.git

# SSH form works too
drev init git@gitlab.com:team/sessions.git

Every command after init is pure git and works against any remote.

Multi-account setup (one machine, two GitHub identities)

If your machine has two GitHub accounts (e.g. work and personal) and only one has access to your Drev repo: see docs/SETUP_MULTI_ACCOUNT.md. The recommended path is an SSH host alias so the two accounts stay fully isolated.

How this was built

Drev v0 was built in a single working session by one engineer using Claude Code as orchestrator with parallel sub-agents as the workforce. 30 narrowly-scoped tasks across 4 phases, up to 10 agents in parallel at peak, 572 passing tests, 96% line coverage on core/, bidirectional cross-OS validation. Build narrative, dispatch pattern, and the four architectural corrections caught by real-world testing: docs/HOW_THIS_WAS_BUILT.md.

License

MIT.