Skip to content

docs: bring README current with v0.2.1; add multi-PC transcript sharing to REMOTE.md#26

Merged
stevepridemore merged 0 commit into
mainfrom
docs/readme-currency-and-multi-pc
May 9, 2026
Merged

docs: bring README current with v0.2.1; add multi-PC transcript sharing to REMOTE.md#26
stevepridemore merged 0 commit into
mainfrom
docs/readme-currency-and-multi-pc

Conversation

@stevepridemore
Copy link
Copy Markdown
Owner

Summary

README was last touched in PR #15 and missed the OAuth hardening pass + the rest of the threat-model closure work. Tool count was stale ("about 20" → actually 23). Multi-PC Claude Code transcript sharing wasn't documented anywhere even though the question naturally comes up the moment you set up the OAuth multi-device story.

Changes

README

  • Status section: adds OAuth 2.1 hardening summary, threat-model fully closed (16/16), npm audit clean, and a link to the v0.2.1 release.
  • Architecture: OAuth one-liner enriched with PKCE-S256 + RFC 7009 references (full hardening detail lives in Status).
  • Tools: count corrected to 23. graph_contradictions added to Query, graph_merge to Write, graph_merge_suggestions to Maintenance.
  • Multi-device section: one-paragraph pointer to the new REMOTE.md subsection clarifying that the OAuth multi-device story and the cross-PC transcript-sharing story are different concerns.

REMOTE.md

  • New "Multi-PC transcript sharing" section between Operational notes and Reverting to local-only.
  • Explains why (dream is a single-machine Claude Code session that only reads that machine's local ~/.claude/projects/; transcripts on other PCs are invisible to extraction even though the MCP server is reachable everywhere).
  • Two general patterns (junction at ~/.claude/projects/ pointing at a synced location, vs direct sync of the canonical path).
  • Two gotchas (active-file sync lag, online-only placeholders in cloud sync tools).
  • Sync-tool agnostic — OneDrive, Dropbox, Syncthing, Google Drive, iCloud, NFS, rsync over Tailscale all listed as examples; no prescription.

Test plan

  • Markdown links resolve (multi-PC anchor in README → docs/REMOTE.md#multi-pc-transcript-sharing).
  • Render the README on GitHub after merge to confirm tool table renders correctly with the added entries.

🤖 Generated with Claude Code

@stevepridemore stevepridemore merged this pull request into main May 9, 2026
2 checks passed
@stevepridemore stevepridemore deleted the docs/readme-currency-and-multi-pc branch May 9, 2026 22:24
stevepridemore added a commit that referenced this pull request May 10, 2026
…ing (#26)

README:
- Status section adds OAuth 2.1 hardening summary, threat-model
  closure (16/16), npm audit clean, and a link to the v0.2.1 release.
- Architecture OAuth one-liner enriched with PKCE-S256 + RFC 7009.
- Tool count corrected to 23 with graph_contradictions, graph_merge,
  and graph_merge_suggestions added to the right rows.
- Added a one-paragraph pointer in the multi-device section to the
  new REMOTE.md subsection on multi-PC transcript sharing.

REMOTE.md:
- New "Multi-PC transcript sharing" section between Operational
  notes and Reverting to local-only. Covers WHY (the dream sees
  only its own machine's ~/.claude/projects/ so transcripts on
  other PCs are invisible to extraction), the two general patterns
  (junction vs direct sync), and two gotchas (active-file sync lag
  and online-only placeholders). Sync-tool agnostic.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant