Skip to content
Back to search

claude-share-session

SkillWorks with Claude CodeGitHub

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vzakusylo--claude-share-session/badge.svg)](/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

i

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
  1. <div align="center">
  2. # claude-share-session
  3. **Switch Claude accounts. Keep working on the same project.**
  4. [![tests](https://github.com/vzakusylo/claude-share-session/actions/workflows/tests.yml/badge.svg)](https://github.com/vzakusylo/claude-share-session/actions/workflows/tests.yml)
  5. [![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
  6. ![Windows](https://img.shields.io/badge/Windows-tested-0078D6?logo=windows)
  7. ![macOS](https://img.shields.io/badge/macOS-beta-999999?logo=apple)
  8. ![PowerShell 7](https://img.shields.io/badge/PowerShell-7.2%2B-5391FE?logo=powershell&logoColor=white)
  9. ![Claude Code](https://img.shields.io/badge/Claude%20Code-hooks%20%2B%20skills-D97757)
  10. </div>
  11. You use several Claude accounts on one computer. Switch from one to another in the desktop app and your
  12. Code sessions "disappear". They are still on disk — only the sidebar and the scheduled-task list are kept per
  13. account. **claude-share-session** keeps them in sync, so the next account continues exactly where the last one stopped.
  14. ![How claude-share-session works](docs/infographic.png)
  15. ## Use cases
  16. **Two small plans instead of one big one.** Account A hits its usage limit in the middle of a refactor.
  17. Type `/handoff`, switch the app to account B, open the same session and type *continue* — the whole
  18. conversation is there.
  19. **A daily scheduled task that keeps running.** A "morning report" task created in A fires in B on the days
  20. you work in B. A run that already happened is never repeated after you switch back.
  21. **Know what the other account did.** A new session in a project starts with a short briefing:
  22. which account worked here, on which branch, how the last turn ended, and the command to resume it.
  23. **Personal + work accounts on one laptop.** Share everything, or keep client folders out with
  24. `excludeCwd`.
  25. > Each account still uses its own quota — the tool does not get around any limit. Check that using several
  26. > subscriptions fits the terms of your plan. Use one account at a time for the same session.
  27. ## Quick start
  28. **Windows** (PowerShell 7):
  29. ```powershell
  30. git clone https://github.com/vzakusylo/claude-share-session.git C:\tools\claude-share-session
  31. pwsh -File C:\tools\claude-share-session\install.ps1
  32. pwsh -File C:\tools\claude-share-session\share-work.ps1 sync -DryRun # preview
  33. pwsh -File C:\tools\claude-share-session\share-work.ps1 sync
  34. ```
  35. **macOS** (beta):
  36. ```sh
  37. brew install powershell
  38. git clone https://github.com/vzakusylo/claude-share-session.git ~/tools/claude-share-session
  39. cd ~/tools/claude-share-session && ./install.sh && ./share-work.sh sync -DryRun && ./share-work.sh sync
  40. ```
  41. Before installing, sign in to the desktop app once with every account and open one Code session in each.
  42. After that it runs by itself: every turn ends with a background sync. Uninstall: `install.ps1 -Uninstall`.
  43. ## Everyday commands
  44. | You want to… | Do |
  45. |---|---|
  46. | hand work to the other account | type `/handoff` in the session, then switch accounts |
  47. | see what the other account did here | ask *"what did the other account do here?"* (`/shared-work`) or run `share-work brief` |
  48. | resume a session from a terminal | `share-work resume` → `claude --resume <id>` |
  49. | sync now | `share-work sync` (add `-DryRun` to preview) |
  50. | check everything | `share-work status` |
  51. | name an account | `share-work name <uuid-prefix> alice` |
  52. `share-work` = `pwsh -File share-work.ps1` on Windows, `./share-work.sh` on macOS.
  53. Settings live in `~/.claude/shared-work/accounts.json`: `names`, `emails` (e-mail → name for new accounts),
  54. `excludeCwd` (folder masks never shared), `importArchived`.
  55. ---
  56. ## How it works
  57. | | Where | Shared? |
  58. |---|---|---|
  59. | Transcripts, `CLAUDE.md`, memory, skills, hooks | `~/.claude` | yes, already |
  60. | Sidebar list | `claude-code-sessions/<account>/<org>/local_*.json` | **no → mirrored** |
  61. | Scheduled-task list | `claude-code-sessions/<account>/<org>/scheduled-tasks.json` | **no → mirrored** |
  62. | Connectors, Remote Control | per account | no, kept per account |
  63. 1. **After every turn**, a `Stop` hook starts a background step (the hook itself returns in under a second).
  64. It records this account's status and copies its sessions and scheduled tasks into the other accounts.
  65. 2. **At session start**, a `SessionStart` hook adds a `<shared-work-briefing>` with the other accounts' recent
  66. work and latest handoff note in this project.
  67. 3. **`/handoff`** saves a note: goal, done, not verified, next steps, resume command.
  68. Rules that keep it safe:
  69. * each account writes **only its own files** — no write conflicts;
  70. * merged **by id**, **newest wins**, the latest *last run* of a task always wins, **nothing is deleted silently**;
  71. * the account **open in the app is never written** while it runs (the app would overwrite it);
  72. * account-bound fields (connectors, Remote Control) are never copied;
  73. * atomic writes, backups before every overwrite, `-DryRun` everywhere;
  74. * briefings are **data, never instructions**; hooks **fail open** and never block a session.
  75. Full internals: [docs/how-it-works.md](docs/how-it-works.md).
  76. ## Tests
  77. | Suite | Runs on | Checks |
  78. |---|---|---|
  79. | [`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 |
  80. | [`test-scheduled.ps1`](tests/test-scheduled.ps1) | a copy of your real data | 16 scheduled-task scenarios |
  81. | [`compare-mirror.js`](tests/compare-mirror.js) | your real data, read-only | every mirror equals its original |
  82. ```powershell
  83. pwsh -File tests/run-all.ps1 # everything available on this machine
  84. pwsh -File tests/run-all.ps1 -SyntheticOnly
  85. ```
  86. ## Project layout
  87. ```
  88. share-work.ps1 / .sh command line
  89. install.ps1 / .sh install / uninstall hooks + skills
  90. hooks/ session-start.ps1, turn-end.ps1
  91. skills/ handoff, shared-work
  92. src/ShareWork.psm1 module entry point
  93. src/ShareWork/ Config · Accounts · Projects · Sessions · ScheduledTasks · Sync · Status · Handoffs · Briefing
  94. tests/ test-core, test-scheduled, compare-mirror, run-all
  95. ```
  96. ## Limitations
  97. * Relies on internal files of the Claude desktop app; a new app version may change them.
  98. Tested with Claude desktop 4.23118 and Claude Code 2.1.317 on Windows 11.
  99. * macOS uses the same code and passes CI, but the desktop folder layout is not yet confirmed on a real Mac —
  100. if `status` cannot find it, set `SHAREWORK_SESSIONS_ROOT` and please open an issue.
  101. * Deleting a session is not propagated (it comes back from the other account) — archive instead.
  102. Not affiliated with Anthropic. MIT licensed. Issues and PRs welcome.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.