@tyroneross/bookmark 0.1.0

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@tyroneross/bookmark",
+  "version": "0.1.0",
+  "description": "Context snapshots for Claude Code — session continuity across compactions and terminals",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "bookmark": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./setup": {
+      "types": "./dist/setup/auto-setup.d.ts",
+      "import": "./dist/setup/auto-setup.js"
+    }
+  },
+  "files": [
+    "dist",
+    "commands",
+    "skills",
+    "hooks",
+    "agents",
+    ".claude-plugin",
+    "scripts/install-plugin.sh",
+    "CLAUDE.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && npm run build:fixshebang",
+    "build:fixshebang": "node -e \"const fs=require('fs');const f='dist/cli/index.js';let c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!')){c='#!/usr/bin/env node\\n'+c;fs.writeFileSync(f,c);}\"",
+    "dev": "tsc --watch",
+    "start": "node dist/cli/index.js",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "postinstall": "node dist/setup/auto-setup.js || true",
+    "install-plugin": "bash scripts/install-plugin.sh --global"
+  },
+  "keywords": [
+    "claude-code",
+    "context",
+    "snapshots",
+    "session-continuity",
+    "compaction",
+    "memory",
+    "devtools"
+  ],
+  "author": "Tyrone Ross",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tyroneross/bookmark"
+  },
+  "homepage": "https://github.com/tyroneross/bookmark#readme",
+  "bugs": {
+    "url": "https://github.com/tyroneross/bookmark/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.0",
+    "glob": "^13.0.0"
+  },
+  "optionalDependencies": {
+    "@anthropic-ai/sdk": "^0.39.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.0"
+  }
+}

package/scripts/install-plugin.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# Install Bookmark as a Claude Code plugin
+# Usage: bash scripts/install-plugin.sh [--global]
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+PLUGIN_DIR="$SCRIPT_DIR"
+
+if [[ "$1" == "--global" ]]; then
+  # Global install — link plugin for all projects
+  CLAUDE_PLUGINS_DIR="$HOME/.claude/plugins"
+  mkdir -p "$CLAUDE_PLUGINS_DIR"
+
+  # Create symlink
+  LINK_PATH="$CLAUDE_PLUGINS_DIR/bookmark"
+  if [ -L "$LINK_PATH" ]; then
+    rm "$LINK_PATH"
+  fi
+  ln -sf "$PLUGIN_DIR" "$LINK_PATH"
+  echo "Bookmark plugin linked globally: $LINK_PATH -> $PLUGIN_DIR"
+else
+  # Project-level install
+  CWD="${2:-$(pwd)}"
+  CLAUDE_DIR="$CWD/.claude"
+  mkdir -p "$CLAUDE_DIR"
+
+  echo "Bookmark plugin installed for project: $CWD"
+  echo ""
+  echo "Commands available:"
+  echo "  /bookmark:snapshot  — Take a manual snapshot"
+  echo "  /bookmark:restore   — Restore from a snapshot"
+  echo "  /bookmark:status    — Show snapshot stats"
+  echo "  /bookmark:list      — List all snapshots"
+fi
+
+echo ""
+echo "Done. Restart your Claude Code session to activate hooks."

package/skills/context-continuity/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: context-continuity
+description: This skill activates when the user mentions "what was I working on", "continue from last session", "restore context", "what did we decide", "pick up where I left off", "compaction happened", "lost context", "session context", or when resuming work after a break. Provides session continuity by accessing bookmark snapshots.
+version: 0.1.0
+---
+
+# Context Continuity Workflow
+
+This skill helps restore and maintain context across Claude Code sessions and compactions.
+
+## When to Activate
+
+- User asks about prior session work
+- User wants to continue a previous task
+- After compaction when context was compressed
+- User reports "losing" context or decisions
+
+## Restoration Flow
+
+1. Check for existing snapshots:
+```bash
+npx @tyroneross/bookmark status
+```
+
+2. If snapshots exist, read the hot context:
+```bash
+npx @tyroneross/bookmark show --latest
+```
+
+3. Present the restored context to the user:
+   - **Current Status**: What was being worked on
+   - **Decisions Made**: Key choices with rationale
+   - **Open Items**: What still needs doing
+   - **Unknowns**: Blockers or questions
+
+4. Ask the user which open item to continue with.
+
+## After Restoration
+
+Once context is restored, continue working normally. The automatic hooks handle future snapshots.
+
+## Manual Snapshot
+
+If the user wants to explicitly save context before a break:
+```bash
+npx @tyroneross/bookmark snapshot --trigger manual
+```
+
+*bookmark — context snapshot*