Metadata-Version: 2.5
Name: multicc-sync
Version: 1.0.0
Summary: Keep the Claude desktop app's session list the same across two accounts on one machine
Project-URL: Homepage, https://github.com/kangkangzi2025/multicc-sync
Project-URL: Repository, https://github.com/kangkangzi2025/multicc-sync
Project-URL: Issues, https://github.com/kangkangzi2025/multicc-sync/issues
Author: Fukang Wen
License-Expression: MIT
License-File: LICENSE
Keywords: accounts,claude,claude-code,desktop,sessions,sync
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Provides-Extra: mcp
Requires-Dist: mcp>=1.2; extra == 'mcp'
Description-Content-Type: text/markdown

# multicc-sync

Two Claude accounts on one Mac, one session list. Sign out of the Claude desktop app
and into another account and every Claude Code session disappears from the sidebar.
Nothing was deleted: transcripts live in `~/.claude/projects` and are shared, but the
app keeps a separate list of sessions per account. `mccsync` makes both accounts list
the same sessions, and keeps them in step afterwards: renames, archives and deletions
made in one account carry over to the other.

It never touches transcripts, never reads tokens, and makes no network calls. Every
write is preceded by a backup.

## Install

```bash
uv tool install multicc-sync
```

Python 3.11 or newer. For the MCP server as well, install `multicc-sync[mcp]`.

## Use

Quit the Claude app, then:

```bash
mccsync
```

That is the whole update. The first run takes the union of both accounts; later runs
carry across whatever changed on either side since the previous run, and say so
entry by entry.

```bash
mccsync -n                  # show the plan, write nothing
mccsync list                # every account and what it lists
mccsync find "case study"   # locate a session in any account, with its transcript path
mccsync adopt               # list terminal-only sessions in the app (experimental)
mccsync restore             # put back the last backup
```

`mccsync --help` lists the rest, including `--keep-deleted` and `--accounts A,B` for
machines with more than two accounts.

For agents, `mccsync-mcp` is a stdio MCP server with four tools: `find_sessions`,
`list_accounts`, `sync_sessions` and `terminal_only_sessions`. Register it in Claude
Code with `claude mcp add multicc-sync -- mccsync-mcp`. The repository carries a
matching skill in `skills/session-sync`.

The app's session index is not a documented interface. This tool was written against
Claude desktop 1.49585.0 on macOS and checks the directory layout before every run;
if the app changes it, `mccsync` stops rather than guesses. Windows and Linux paths
are present but untested.

MIT license.
