server.js

#!/usr/bin/env node
'use strict';

/**
 * cc-vis — a session visualizer for Claude Code transcripts.
 *
 * Mirrors the kimi vis architecture: read local session data directly from
 * disk, expose it over a small read-only HTTP API, and serve an embedded
 * single-page app to inspect it. No LLM calls, no build step, no deps.
 *
 * Data source: ~/.claude/projects/<project-slug>/<session-id>.jsonl
 *              ~/.claude/projects/<project-slug>/<session-id>/subagents/agent-*.jsonl
 *
 * Usage:
 *   cc-vis [--port N] [--host H] [--no-open]
 *   VIS_AUTH_TOKEN=secret cc-vis --host 0.0.0.0   # required off-loopback
 */

const path = require('node:path');
const os = require('node:os');
const { exec } = require('node:child_process');
const { createServer } = require('./src/httpd');

function parseArgs(argv) {
  const opts = { port: 0, host: '127.0.0.1', open: true };
  for (let i = 2; i < argv.length; i++) {
    const a = argv[i];
    if (a === '--port') opts.port = Number(argv[++i]);
    else if (a === '--host') opts.host = argv[++i];
    else if (a === '--no-open') opts.open = false;
    else if (a === '--help' || a === '-h') {
      console.log('cc-vis [--port N] [--host H] [--no-open]');
      process.exit(0);
    }
  }
  return opts;
}

function isLoopback(host) {
  return host === '127.0.0.1' || host === 'localhost' || host === '::1' || host === '[::1]';
}

async function main() {
  const opts = parseArgs(process.argv);
  const claudeHome = process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), '.claude');
  const projectsDir = path.join(claudeHome, 'projects');
  const publicDir = path.join(__dirname, 'public');

  const authToken = (process.env.VIS_AUTH_TOKEN || '').trim() || undefined;
  if (!isLoopback(opts.host) && !authToken) {
    console.error(`VIS_AUTH_TOKEN is required when binding cc-vis outside loopback (host=${opts.host})`);
    process.exit(1);
  }

  const server = createServer({ projectsDir, publicDir, authToken });
  await new Promise((resolve, reject) => {
    server.once('error', reject);
    server.listen(opts.port, opts.host, resolve);
  });
  const { port } = server.address();
  const auth = authToken ? 'auth=required' : 'auth=disabled';
  const url = `http://${opts.host}:${String(port)}`;
  console.log(`[cc-vis] listening on ${url} (${auth}, CLAUDE_HOME=${claudeHome})`);

  if (opts.open && isLoopback(opts.host)) {
    const opener =
      process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
    exec(`${opener} ${url}`, () => {});
  }
}

main().catch((err) => {
  console.error(`[cc-vis] fatal: ${(err && err.stack) || err}`);
  process.exit(1);
});