claude-home 1.0.0

package/README.md

@@ -0,0 +1,117 @@
+# claude-home
+
+A local web dashboard for [Claude Code](https://claude.ai/code) power users.
+
+Browse your session history, manage skills, agents, hooks, commands, plans, and discover community skills — all from a clean UI. No tokens consumed. Runs entirely on your machine.
+
+---
+
+## Why claude-home?
+
+Claude Code is powerful but headless. Everything lives in files scattered across `~/.claude/` and your project directories. claude-home gives you a visual interface to explore and manage all of it:
+
+- **Session history** — browse every conversation you've had with Claude, search by content, resume from where you left off
+- **Skills** — view, create, edit and delete your user and project skills. Discover and install new ones from the community marketplace or any GitHub URL
+- **Agents** — manage your custom agent definitions with full CRUD
+- **Instructions** — read and edit your `CLAUDE.md` files (global and per-project), the instructions that shape Claude's behavior in every session
+- **Permissions** — inspect the allow/deny lists that control what Claude can do in each project
+- **Hooks** — view and manage all your configured hooks across global and project settings
+- **Commands** — browse your slash command library
+- **Plans** — read and search your GSD/planning files
+- **Memory** — inspect your auto-memory entries across projects
+- **Configuration** — view Claude settings per project
+
+### 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 feature, which optionally fetches from GitHub).
+
+---
+
+## Installation
+
+### From GitHub
+
+```bash
+npm install -g ZenekeZene/claude-home
+```
+
+> Requires Node.js 18+. You'll need access to the repository.
+
+### From source
+
+```bash
+git clone https://github.com/ZenekeZene/claude-home
+cd claude-home
+npm install
+npm start
+```
+
+---
+
+## Usage
+
+```bash
+claude-home
+```
+
+Opens `http://localhost:3141` in your browser automatically.
+
+### Auto-launch on every Claude session
+
+Run this once to register a hook that starts claude-home in the background whenever you open Claude Code:
+
+```bash
+claude-home setup-hook
+```
+
+This also creates a `/claude-home` slash command so you can trigger it from any Claude session.
+
+### CLI flags
+
+```
+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
+
+Commands:
+  setup-hook       Add SessionStart hook + /claude-home slash command
+```
+
+---
+
+## Skills Marketplace
+
+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/sessions-browser/marketplace.json`:
+
+```json
+{
+  "sources": [
+    {
+      "id": "my-org",
+      "name": "My Org Skills",
+      "owner": "my-org",
+      "repo": "our-skills",
+      "branch": "main",
+      "skillsPath": "",
+      "tokenEnv": "GITHUB_TOKEN"
+    }
+  ]
+}
+```
+
+For private repos, set your token in `~/.claude/sessions-browser/.env`:
+
+```
+GITHUB_TOKEN=ghp_your_token_here
+```
+
+---
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+'use strict';
+
+const net = require('net');
+const { exec } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+const pkg = require('../package.json');
+
+// ─── Arg parsing ─────────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+const subcommand = args[0];
+
+function getFlag(name, def) {
+  const idx = args.indexOf(name);
+  if (idx === -1) return def;
+  return args[idx + 1];
+}
+
+const port = parseInt(getFlag('--port', getFlag('-p', process.env.PORT || 3141)), 10);
+const noOpen = args.includes('--no-open');
+
+if (args.includes('--version') || args.includes('-v')) {
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`
+  claude-home v${pkg.version}
+
+  Usage:
+    claude-home [options]
+    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
+
+  Commands:
+    setup-hook       Add SessionStart hook and /claude-home slash command
+  `);
+  process.exit(0);
+}
+
+// ─── Setup-hook subcommand ────────────────────────────────────────────────────
+
+if (subcommand === 'setup-hook') {
+  setupHook();
+  process.exit(0);
+}
+
+// ─── Main: start server or reuse existing ────────────────────────────────────
+
+isPortFree(port).then(free => {
+  if (free) {
+    const { startServer } = require('../server.js');
+    startServer(port);
+  } else {
+    console.log(`Claude Manager already running at http://localhost:${port}`);
+  }
+  if (!noOpen) openBrowser(`http://localhost:${port}`);
+});
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+function isPortFree(p) {
+  return new Promise(resolve => {
+    const s = net.createServer();
+    s.once('error', () => resolve(false));
+    s.once('listening', () => s.close(() => resolve(true)));
+    s.listen(p);
+  });
+}
+
+function openBrowser(url) {
+  const cmd = process.platform === 'darwin' ? `open "${url}"`
+    : process.platform === 'win32' ? `start "" "${url}"`
+    : `xdg-open "${url}"`;
+  exec(cmd, err => {
+    if (err) console.log(`Open in browser: ${url}`);
+  });
+}
+
+function setupHook() {
+  const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
+  const commandsDir = path.join(os.homedir(), '.claude', 'commands');
+  const commandPath = path.join(commandsDir, 'claude-home.md');
+  const hookCommand = `lsof -ti:${port} >/dev/null 2>&1 || (claude-home --no-open &>/dev/null &)`;
+
+  // Add SessionStart hook to settings.json
+  let settings = {};
+  try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch { /* new file */ }
+  if (!settings.hooks) settings.hooks = {};
+  if (!settings.hooks.SessionStart) settings.hooks.SessionStart = [];
+
+  const alreadyExists = settings.hooks.SessionStart.some(entry =>
+    entry.hooks?.some(h => h.command?.includes('claude-home'))
+  );
+
+  if (!alreadyExists) {
+    settings.hooks.SessionStart.push({
+      matcher: '',
+      hooks: [{ type: 'command', command: hookCommand }],
+    });
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+    console.log(`✓ SessionStart hook added to ${settingsPath}`);
+  } else {
+    console.log(`  SessionStart hook already present — skipped`);
+  }
+
+  // Create /claude-home slash command
+  if (!fs.existsSync(commandsDir)) fs.mkdirSync(commandsDir, { recursive: true });
+  if (!fs.existsSync(commandPath)) {
+    fs.writeFileSync(commandPath, [
+      '---',
+      'description: Start the Claude Manager web dashboard',
+      '---',
+      '',
+      'Start the Claude Manager web dashboard if not already running, then open it in the browser.',
+      '',
+      '```bash',
+      `lsof -ti:${port} >/dev/null 2>&1 && echo "Claude Manager running at http://localhost:${port}" || (claude-home &)`,
+      '```',
+    ].join('\n'), 'utf8');
+    console.log(`✓ Slash command created at ${commandPath}`);
+  } else {
+    console.log(`  Slash command already present — skipped`);
+  }
+
+  console.log('\nDone! Restart Claude Code for the hook to take effect.');
+}

package/marketplace.default.json

@@ -0,0 +1,13 @@
+{
+  "sources": [
+    {
+      "id": "anthropic",
+      "name": "Anthropic Official",
+      "owner": "anthropics",
+      "repo": "skills",
+      "branch": "main",
+      "skillsPath": "skills",
+      "token": ""
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "claude-home",
+  "version": "1.0.0",
+  "description": "Web dashboard for Claude Code — browse sessions, manage skills, hooks, commands, and agents",
+  "main": "server.js",
+  "bin": {
+    "claude-home": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "server.js",
+    "public/",
+    "marketplace.default.json",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node server.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZenekeZene/claude-home.git"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "sessions",
+    "dashboard",
+    "cli",
+    "skills",
+    "agents"
+  ],
+  "author": "ZenekeZene",
+  "license": "MIT",
+  "dependencies": {
+    "express": "^4.18.2"
+  }
+}