claude-home 1.8.0 → 1.8.3

package/README.md

@@ -53,7 +53,7 @@ Direct links (`#/note/filename`) let you open a specific note instantly.
 Visual overview of all your Claude projects with session count, token usage, cost, and memory files. Drill into any project to browse its sessions, memory entries, and `CLAUDE.md` files.
 
 ### Plans
-Read and search your GSD/planning files from `~/.claude/plans/`. Export or publish as a Gist with one click.
+Read and search your GSD/planning files from `~/.claude/plans/` (or your configured config dir). Export or publish as a Gist with one click.
 
 ### Memory
 Inspect your auto-memory entries across all projects.
@@ -68,7 +68,7 @@ Read and edit your `CLAUDE.md` files (global and per-project). Inspect permissio
 
 ## No tokens. No cloud. No tracking.
 
-claude-home is a local Express server that reads your `~/.claude/` directory directly. It never calls the Claude API, never sends data anywhere, and works completely offline (except for the marketplace and Gist sharing features).
+claude-home is a local Express server that reads your Claude config directory (`~/.claude/` by default) directly. It never calls the Claude API, never sends data anywhere, and works completely offline (except for the marketplace and Gist sharing features).
 
 ---
 
@@ -86,15 +86,6 @@ npm install -g claude-home
 
 > Requires Node.js 18+.
 
-### From source
-
-```bash
-git clone https://github.com/ZenekeZene/claude-home
-cd claude-home
-npm install
-npm start
-```
-
 ---
 
 ## Usage
@@ -123,10 +114,12 @@ Or toggle it directly from the **Hooks** section in the UI.
 ```
 claude-home [options]
 
-  --port, -p <n>   Port to use (default: 3141)
-  --no-open        Don't open the browser automatically
-  --version, -v    Print version
-  --help, -h       Show help
+  --port, -p <n>      Port to use (default: 3141)
+  --no-open           Don't open the browser automatically
+  --config-dir <path> Claude config directory (default: ~/.claude)
+                        Also: CLAUDE_CONFIG_DIR env var
+  --version, -v       Print version
+  --help, -h          Show help
 
 Commands:
   setup-hook       Add SessionStart hook + /claude-home slash command
@@ -134,11 +127,28 @@ Commands:
   stop             Stop the running claude-home server
 ```
 
+### Multiple Claude installations
+
+If you use separate Claude Code configurations (e.g. `~/.claude` for personal and `~/.claude-work` for work), you can point claude-home at any of them:
+
+```bash
+# Via flag
+claude-home --config-dir ~/.claude-work
+
+# Via environment variable
+CLAUDE_CONFIG_DIR=~/.claude-work claude-home
+
+# Install the auto-start hook into the work config
+claude-home --config-dir ~/.claude-work setup-hook
+```
+
+The dashboard will read sessions, settings, skills, commands, agents, and plans from the specified directory. The UI will reflect the correct paths throughout.
+
 ---
 
 ## Claude integration (Notes & Today)
 
-claude-home can receive content directly from Claude during active sessions. Go to **Config → Integrations** and click **Set up** — this adds instructions to your `~/.claude/CLAUDE.md` and grants the necessary write permissions automatically.
+claude-home can receive content directly from Claude during active sessions. Go to **Config → Integrations** and click **Set up** — this adds instructions to your `CLAUDE.md` and grants the necessary write permissions automatically.
 
 Once set up, from any Claude session you can say:
 - *"Save this as a note"* → creates a note in the Notes view
@@ -157,7 +167,7 @@ Publish sessions or plans as public GitHub Gists. Go to **Config → Sharing**,
 
 claude-home includes a marketplace to discover and install skills from GitHub repositories.
 
-On first run it comes pre-configured with the [Anthropic Official skills repo](https://github.com/anthropics/skills). You can add your own sources (including private repos) by editing `~/.claude/claude-home/marketplace.json`:
+On first run it comes pre-configured with the [Anthropic Official skills repo](https://github.com/anthropics/skills). You can add your own sources (including private repos) by editing `~/.claude/claude-home/marketplace.json` (or the equivalent in your configured config dir):
 
 ```json
 {
@@ -175,7 +185,7 @@ On first run it comes pre-configured with the [Anthropic Official skills repo](h
 }
 ```
 
-For private repos, set your token in `~/.claude/claude-home/.env`:
+For private repos, set your token in `~/.claude/claude-home/.env` (or your config dir equivalent):
 
 ```
 GITHUB_TOKEN=ghp_your_token_here

package/bin/cli.js

@@ -9,18 +9,7 @@ const os = require('os');
 
 const pkg = require('../package.json');
 
-// ─── Ensure data dir exists (always, before any subcommand) ──────────────────
-const DATA_DIR = path.join(os.homedir(), '.claude', 'claude-home');
-try {
-  if (!fs.existsSync(DATA_DIR)) fs.mkdirSync(DATA_DIR, { recursive: true });
-  const marketplaceDest = path.join(DATA_DIR, 'marketplace.json');
-  if (!fs.existsSync(marketplaceDest)) {
-    const defaultSrc = path.join(__dirname, '..', 'marketplace.default.json');
-    if (fs.existsSync(defaultSrc)) fs.copyFileSync(defaultSrc, marketplaceDest);
-  }
-} catch { /* ignore */ }
-
-// ─── Arg parsing ─────────────────────────────────────────────────────────────
+// ─── Arg parsing (must happen before path derivation) ────────────────────────
 
 const args = process.argv.slice(2);
 const subcommand = args[0];
@@ -31,9 +20,25 @@ function getFlag(name, def) {
   return args[idx + 1];
 }
 
+const configDirFlag = getFlag('--config-dir', '');
+if (configDirFlag) process.env.CLAUDE_CONFIG_DIR = path.resolve(configDirFlag);
+
 const port = parseInt(getFlag('--port', getFlag('-p', process.env.PORT || 3141)), 10);
 const noOpen = args.includes('--no-open');
 
+// ─── Config directory + data dir ─────────────────────────────────────────────
+const CLAUDE_DIR = process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), '.claude');
+const DATA_DIR   = path.join(CLAUDE_DIR, 'claude-home');
+
+try {
+  if (!fs.existsSync(DATA_DIR)) fs.mkdirSync(DATA_DIR, { recursive: true });
+  const marketplaceDest = path.join(DATA_DIR, 'marketplace.json');
+  if (!fs.existsSync(marketplaceDest)) {
+    const defaultSrc = path.join(__dirname, '..', 'marketplace.default.json');
+    if (fs.existsSync(defaultSrc)) fs.copyFileSync(defaultSrc, marketplaceDest);
+  }
+} catch { /* ignore */ }
+
 if (args.includes('--version') || args.includes('-v')) {
   console.log(pkg.version);
   process.exit(0);
@@ -48,10 +53,12 @@ if (args.includes('--help') || args.includes('-h')) {
     claude-home setup-hook
 
   Options:
-    --port, -p <n>   Port to use (default: 3141)
-    --no-open        Don't open the browser automatically
-    --version, -v    Print version
-    --help, -h       Show help
+    --port, -p <n>      Port to use (default: 3141)
+    --no-open           Don't open the browser automatically
+    --config-dir <path> Claude config directory (default: ~/.claude)
+                          Also: CLAUDE_CONFIG_DIR env var
+    --version, -v       Print version
+    --help, -h          Show help
 
   Commands:
     setup-hook       Add SessionStart hook and /claude-home slash command
@@ -102,7 +109,7 @@ promptSetupHookIfNeeded().then(() => {
 // ─── Update check ────────────────────────────────────────────────────────────
 
 function checkForUpdates() {
-  const cacheFile = path.join(os.homedir(), '.claude', 'claude-home', '.update-check');
+  const cacheFile = path.join(DATA_DIR, '.update-check');
   const TTL = 24 * 60 * 60 * 1000; // 24h
 
   try {
@@ -149,8 +156,8 @@ function isPortFree(p) {
 }
 
 function promptSetupHookIfNeeded() {
-  const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
-  const sentinelPath = path.join(os.homedir(), '.claude', 'claude-home', '.hook-prompted');
+  const settingsPath = path.join(CLAUDE_DIR, 'settings.json');
+  const sentinelPath = path.join(DATA_DIR, '.hook-prompted');
 
   // Already prompted before, or hook already set up
   if (fs.existsSync(sentinelPath)) return Promise.resolve();
@@ -186,8 +193,8 @@ function openBrowser(url) {
 }
 
 function setupHook() {
-  const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
-  const commandsDir = path.join(os.homedir(), '.claude', 'commands');
+  const settingsPath = path.join(CLAUDE_DIR, 'settings.json');
+  const commandsDir = path.join(CLAUDE_DIR, 'commands');
   const commandPath = path.join(commandsDir, 'claude-home.md');
   const hookCommand = `lsof -ti:${port} >/dev/null 2>&1 || (claude-home --no-open &>/dev/null &)`;
 
@@ -235,9 +242,9 @@ function setupHook() {
 }
 
 function removeHook() {
-  const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
-  const commandPath = path.join(os.homedir(), '.claude', 'commands', 'claude-home.md');
-  const sentinelPath = path.join(os.homedir(), '.claude', 'claude-home', '.hook-prompted');
+  const settingsPath = path.join(CLAUDE_DIR, 'settings.json');
+  const commandPath = path.join(CLAUDE_DIR, 'commands', 'claude-home.md');
+  const sentinelPath = path.join(DATA_DIR, '.hook-prompted');
 
   // Remove SessionStart hook
   let removed = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-home",
-  "version": "1.8.0",
+  "version": "1.8.3",
   "description": "Web dashboard for Claude Code — browse sessions, manage skills, hooks, commands, and agents",
   "main": "server.js",
   "bin": {
@@ -14,7 +14,12 @@
     "README.md"
   ],
   "scripts": {
-    "start": "node server.js"
+    "start": "node server.js",
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "engines": {
     "node": ">=18"
@@ -35,6 +40,20 @@
   "author": "ZenekeZene",
   "license": "MIT",
   "dependencies": {
-    "express": "^4.18.2"
+    "@tanstack/react-query": "^5.96.2",
+    "express": "^4.18.2",
+    "highlight.js": "^11.11.1",
+    "marked": "^17.0.6",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.30.3"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@vitejs/plugin-react": "^6.0.1",
+    "jsdom": "^29.0.2",
+    "vitest": "^3.2.4"
   }
 }