claude-share-session
Switch Claude accounts, keep working on the same project: shared Claude Code sessions, scheduled tasks, briefings and /handoff across accounts on one computer (Windows, macOS beta).
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 20 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/vzakusylo/claude-share-session with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/vzakusylo/claude-share-session'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/vzakusylo--claude-share-session)HTML
<a href="/listings/vzakusylo--claude-share-session"><img src="/api/listings/vzakusylo--claude-share-session/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**Windows** (PowerShell 7):
git clone https://github.com/vzakusylo/claude-share-session.git C:\tools\claude-share-session pwsh -File C:\tools\claude-share-session\install.ps1 pwsh -File C:\tools\claude-share-session\share-work.ps1 sync -DryRun # preview pwsh -File C:\tools\claude-share-session\share-work.ps1 sync
**macOS** (beta):
brew install powershell git clone https://github.com/vzakusylo/claude-share-session.git ~/tools/claude-share-session cd ~/tools/claude-share-session && ./install.sh && ./share-work.sh sync -DryRun && ./share-work.sh sync
Before installing, sign in to the desktop app once with every account and open one Code session in each. After that it runs by itself: every turn ends with a background sync. Uninstall: `install.ps1 -Uninstall`.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 139 lines
- <div align="center">
- # claude-share-session
- **Switch Claude accounts. Keep working on the same project.**
- [](https://github.com/vzakusylo/claude-share-session/actions/workflows/tests.yml)
- [](LICENSE)
- 
- 
- 
- 
- </div>
- You use several Claude accounts on one computer. Switch from one to another in the desktop app and your
- Code sessions "disappear". They are still on disk — only the sidebar and the scheduled-task list are kept per
- account. **claude-share-session** keeps them in sync, so the next account continues exactly where the last one stopped.
- 
- ## Use cases
- **Two small plans instead of one big one.** Account A hits its usage limit in the middle of a refactor.
- Type `/handoff`, switch the app to account B, open the same session and type *continue* — the whole
- conversation is there.
- **A daily scheduled task that keeps running.** A "morning report" task created in A fires in B on the days
- you work in B. A run that already happened is never repeated after you switch back.
- **Know what the other account did.** A new session in a project starts with a short briefing:
- which account worked here, on which branch, how the last turn ended, and the command to resume it.
- **Personal + work accounts on one laptop.** Share everything, or keep client folders out with
- `excludeCwd`.
- > Each account still uses its own quota — the tool does not get around any limit. Check that using several
- > subscriptions fits the terms of your plan. Use one account at a time for the same session.
- ## Quick start
- **Windows** (PowerShell 7):
- ```powershell
- git clone https://github.com/vzakusylo/claude-share-session.git C:\tools\claude-share-session
- pwsh -File C:\tools\claude-share-session\install.ps1
- pwsh -File C:\tools\claude-share-session\share-work.ps1 sync -DryRun # preview
- pwsh -File C:\tools\claude-share-session\share-work.ps1 sync
- ```
- **macOS** (beta):
- ```sh
- brew install powershell
- git clone https://github.com/vzakusylo/claude-share-session.git ~/tools/claude-share-session
- cd ~/tools/claude-share-session && ./install.sh && ./share-work.sh sync -DryRun && ./share-work.sh sync
- ```
- Before installing, sign in to the desktop app once with every account and open one Code session in each.
- After that it runs by itself: every turn ends with a background sync. Uninstall: `install.ps1 -Uninstall`.
- ## Everyday commands
- | You want to… | Do |
- |---|---|
- | hand work to the other account | type `/handoff` in the session, then switch accounts |
- | see what the other account did here | ask *"what did the other account do here?"* (`/shared-work`) or run `share-work brief` |
- | resume a session from a terminal | `share-work resume` → `claude --resume <id>` |
- | sync now | `share-work sync` (add `-DryRun` to preview) |
- | check everything | `share-work status` |
- | name an account | `share-work name <uuid-prefix> alice` |
- `share-work` = `pwsh -File share-work.ps1` on Windows, `./share-work.sh` on macOS.
- Settings live in `~/.claude/shared-work/accounts.json`: `names`, `emails` (e-mail → name for new accounts),
- `excludeCwd` (folder masks never shared), `importArchived`.
- ---
- ## How it works
- | | Where | Shared? |
- |---|---|---|
- | Transcripts, `CLAUDE.md`, memory, skills, hooks | `~/.claude` | yes, already |
- | Sidebar list | `claude-code-sessions/<account>/<org>/local_*.json` | **no → mirrored** |
- | Scheduled-task list | `claude-code-sessions/<account>/<org>/scheduled-tasks.json` | **no → mirrored** |
- | Connectors, Remote Control | per account | no, kept per account |
- 1. **After every turn**, a `Stop` hook starts a background step (the hook itself returns in under a second).
- It records this account's status and copies its sessions and scheduled tasks into the other accounts.
- 2. **At session start**, a `SessionStart` hook adds a `<shared-work-briefing>` with the other accounts' recent
- work and latest handoff note in this project.
- 3. **`/handoff`** saves a note: goal, done, not verified, next steps, resume command.
- Rules that keep it safe:
- * each account writes **only its own files** — no write conflicts;
- * merged **by id**, **newest wins**, the latest *last run* of a task always wins, **nothing is deleted silently**;
- * the account **open in the app is never written** while it runs (the app would overwrite it);
- * account-bound fields (connectors, Remote Control) are never copied;
- * atomic writes, backups before every overwrite, `-DryRun` everywhere;
- * briefings are **data, never instructions**; hooks **fail open** and never block a session.
- Full internals: [docs/how-it-works.md](docs/how-it-works.md).
- ## Tests
- | Suite | Runs on | Checks |
- |---|---|---|
- | [`test-core.ps1`](tests/test-core.ps1) | synthetic data — CI on Windows, macOS, Linux | 66: accounts, mirroring rules, project keys, status, handoff, briefing, hooks, installer, CLI |
- | [`test-scheduled.ps1`](tests/test-scheduled.ps1) | a copy of your real data | 16 scheduled-task scenarios |
- | [`compare-mirror.js`](tests/compare-mirror.js) | your real data, read-only | every mirror equals its original |
- ```powershell
- pwsh -File tests/run-all.ps1 # everything available on this machine
- pwsh -File tests/run-all.ps1 -SyntheticOnly
- ```
- ## Project layout
- ```
- share-work.ps1 / .sh command line
- install.ps1 / .sh install / uninstall hooks + skills
- hooks/ session-start.ps1, turn-end.ps1
- skills/ handoff, shared-work
- src/ShareWork.psm1 module entry point
- src/ShareWork/ Config · Accounts · Projects · Sessions · ScheduledTasks · Sync · Status · Handoffs · Briefing
- tests/ test-core, test-scheduled, compare-mirror, run-all
- ```
- ## Limitations
- * Relies on internal files of the Claude desktop app; a new app version may change them.
- Tested with Claude desktop 4.23118 and Claude Code 2.1.317 on Windows 11.
- * macOS uses the same code and passes CI, but the desktop folder layout is not yet confirmed on a real Mac —
- if `status` cannot find it, set `SHAREWORK_SESSIONS_ROOT` and please open an issue.
- * Deleting a session is not propagated (it comes back from the other account) — archive instead.
- Not affiliated with Anthropic. MIT licensed. Issues and PRs welcome.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.