dev-prism 0.1.0 → 0.3.0

package/README.md

@@ -1,5 +1,9 @@
 # dev-prism
 
+<p align="center">
+  <img src="banner.png" alt="dev-prism - One codebase, many parallel sessions" width="600">
+</p>
+
 A minimal CLI tool for managing isolated parallel development sessions. Enables multiple Claude Code (or human developer) sessions to work on the same repo simultaneously with complete isolation.
 
 ## Philosophy
@@ -13,10 +17,13 @@ All Docker configuration lives in `docker-compose.session.yml` in your project -
 
 ## Features
 
-- **Git worktrees** for isolated working directories
+- **Git worktrees** for isolated working directories (or in-place mode)
 - **Docker Compose** handles all container orchestration
-- **Unique ports** per session (calculated from session ID)
+- **Unique ports** per session (calculated from session ID, displayed as clickable URLs)
+- **Auto-assign** session IDs or choose your own
+- **SQLite tracking** — all sessions stored in a local database
 - **Two modes**: Docker (apps in containers) or Native (apps run locally)
+- **Claude Code integration** built-in (`dev-prism claude`)
 - **Portable**: Works with any project
 
 ## Installation
@@ -32,17 +39,27 @@ pnpm add -D dev-prism
 ### Create a session
 
 ```bash
-# Docker mode (default) - apps run in containers
+# Auto-assign session ID
+dev-prism create
+
+# Explicit session ID
 dev-prism create 001
 
+# Custom branch name
+dev-prism create --branch feature/my-feature
+
 # Native mode - only infrastructure in Docker, apps run via pnpm dev
-dev-prism create 001 --mode=native
+dev-prism create --mode native
+
+# Exclude specific apps from Docker
+dev-prism create --without web,widget
 
 # In-place mode - use current directory instead of creating worktree
-dev-prism create 001 --in-place
-```
+dev-prism create --in-place
 
-**Note:** In-place sessions are not shown in `dev-prism list` (which only lists worktree-based sessions). Use `dev-prism info` from within an in-place session directory to see its details.
+# Stream logs after creation instead of detaching
+dev-prism create --no-detach
+```
 
 ### List sessions
 
@@ -70,11 +87,20 @@ dev-prism stop-all   # Stop all sessions
 dev-prism logs 001
 ```
 
-### Destroy a session
+### Cleanup
 
 ```bash
 dev-prism destroy 001     # Destroy specific session
 dev-prism destroy --all   # Destroy all sessions
+dev-prism prune           # Remove all stopped sessions
+dev-prism prune -y        # Skip confirmation
+```
+
+### Claude Code integration
+
+```bash
+dev-prism claude          # Install Claude Code skill + CLAUDE.md
+dev-prism claude --force  # Overwrite existing files
 ```
 
 ## Port Allocation
@@ -85,36 +111,50 @@ With base port 47000:
 
 | Service        | Session 001 | Session 002 | Session 003 |
 |----------------|-------------|-------------|-------------|
-| CONVAS_APP_PORT| 47100       | 47200       | 47300       |
-| CONVAS_WEB_PORT| 47101       | 47201       | 47301       |
+| APP_PORT       | 47100       | 47200       | 47300       |
+| WEB_PORT       | 47101       | 47201       | 47301       |
 | POSTGRES_PORT  | 47110       | 47210       | 47310       |
 | MAILPIT_SMTP   | 47111       | 47211       | 47311       |
 | MAILPIT_WEB    | 47112       | 47212       | 47312       |
 
 ## Configuration
 
-### session.config.mjs (minimal)
+### session.config.mjs
 
 ```javascript
 export default {
+  // Required
   portBase: 47000,
   sessionsDir: '../my-project-sessions',
 
   // Port offsets - become env vars for docker-compose
+  // Formula: portBase + (sessionId * 100) + offset
   ports: {
-    POSTGRES_PORT: 10,
-    REDIS_PORT: 11,
-    APP_PORT: 0,
+    APP_PORT: 0,        // 47100, 47200, 47300...
+    WEB_PORT: 1,        // 47101, 47201, 47301...
+    POSTGRES_PORT: 10,  // 47110, 47210, 47310...
+    REDIS_PORT: 11,     // 47111, 47211, 47311...
   },
 
-  // Optional: app-specific env for CLI commands from host
+  // Docker Compose profiles for app containers (used in docker mode)
+  // These match service names with `profiles: ["app-name"]` in docker-compose
+  apps: ['app', 'web'],
+
+  // .env files to copy to session worktree (DATABASE_URL auto-updated)
+  envFiles: [
+    'apps/my-app/.env',
+    'packages/db/.env',
+  ],
+
+  // Commands to run after session creation
+  setup: ['pnpm install', 'pnpm db:push'],
+
+  // Optional: app-specific env for CLI commands from host (native mode)
   appEnv: {
     'apps/my-app': {
       DATABASE_URL: 'postgresql://postgres:postgres@localhost:${POSTGRES_PORT}/postgres',
     },
   },
-
-  setup: ['pnpm install', 'pnpm db:push'],
 };
 ```
 
@@ -153,9 +193,11 @@ services:
 
 ## How It Works
 
-1. **Create session**: `dev-prism create 001`
-   - Creates git worktree at `../project-sessions/session-001`
+1. **Create session**: `dev-prism create`
+   - Auto-assigns next available session ID (or use explicit ID)
+   - Creates git worktree at `../project-sessions/session-001` (or uses current dir with `--in-place`)
    - Generates `.env.session` with calculated ports
+   - Records session in local SQLite database
    - Runs `docker compose --env-file .env.session up -d`
    - Runs setup commands
 
@@ -164,6 +206,8 @@ services:
 3. **Docker mode** (`--profile apps`): All services including apps run in containers
 4. **Native mode**: Only infrastructure runs; apps use `pnpm dev` with `.env.session`
 
+All session state is tracked in a SQLite database (`~/.dev-prism/sessions.db`), making both worktree and in-place sessions first-class citizens across all commands.
+
 ## Generated Files
 
 ```
@@ -179,7 +223,7 @@ SESSION_ID=001
 POSTGRES_PORT=47110
 MAILPIT_SMTP_PORT=47111
 MAILPIT_WEB_PORT=47112
-CONVAS_APP_PORT=47100
+APP_PORT=47100
 ```
 
 ## Portability
@@ -189,4 +233,4 @@ To use in another project:
 1. Install: `pnpm add -D dev-prism`
 2. Create `session.config.mjs` with port offsets
 3. Create `docker-compose.session.yml` with `${VAR}` placeholders
-4. Run `dev-prism create 001`
+4. Run `dev-prism create`

package/bin/dev-prism.js

@@ -5,13 +5,19 @@ import { createSession } from '../dist/commands/create.js';
 import { destroySession } from '../dist/commands/destroy.js';
 import { listSessions } from '../dist/commands/list.js';
 import { installClaude } from '../dist/commands/claude.js';
+import { showInfo } from '../dist/commands/info.js';
+import { startSession } from '../dist/commands/start.js';
+import { stopSession } from '../dist/commands/stop.js';
+import { stopAllSessions } from '../dist/commands/stop-all.js';
+import { pruneSessions } from '../dist/commands/prune.js';
+import { streamLogs } from '../dist/commands/logs.js';
 
 const program = new Command();
 
 program
   .name('dev-prism')
   .description('CLI tool for managing isolated parallel development sessions')
-  .version('0.1.0');
+  .version('0.3.0');
 
 program
   .command('create [sessionId]')
@@ -53,52 +59,7 @@ program
   .command('info')
   .description('Show session info for current directory (useful for --in-place sessions)')
   .action(async () => {
-    const cwd = process.cwd();
-    const chalk = (await import('chalk')).default;
-    const { existsSync, readFileSync } = await import('node:fs');
-    const { resolve } = await import('node:path');
-    const docker = await import('../dist/lib/docker.js');
-
-    const envFile = resolve(cwd, '.env.session');
-    if (!existsSync(envFile)) {
-      console.log(chalk.yellow('No .env.session found in current directory.'));
-      console.log(chalk.gray('Run `dev-prism create --in-place` to create a session here.'));
-      process.exit(1);
-    }
-
-    // Parse .env.session
-    const envContent = readFileSync(envFile, 'utf-8');
-    const env = {};
-    for (const line of envContent.split('\n')) {
-      const match = line.match(/^([^=]+)=(.*)$/);
-      if (match) {
-        env[match[1]] = match[2];
-      }
-    }
-
-    const sessionId = env.SESSION_ID || 'unknown';
-    const running = await docker.isRunning({ cwd });
-
-    console.log(chalk.blue(`\nSession ${sessionId}`));
-    console.log(chalk.gray(`Directory: ${cwd}`));
-    console.log(running ? chalk.green('Status: running') : chalk.yellow('Status: stopped'));
-
-    console.log(chalk.gray('\nPorts:'));
-    for (const [key, value] of Object.entries(env)) {
-      if (key.includes('PORT')) {
-        console.log(chalk.gray(`  ${key}: ${value}`));
-      }
-    }
-
-    console.log(chalk.gray('\nURLs:'));
-    for (const [key, value] of Object.entries(env)) {
-      if (key.includes('APP') || key.includes('WEB') || key.includes('WIDGET')) {
-        if (key.includes('PORT')) {
-          console.log(chalk.cyan(`  ${key.replace('_PORT', '')}: http://localhost:${value}`));
-        }
-      }
-    }
-    console.log('');
+    await showInfo(process.cwd());
   });
 
 program
@@ -108,19 +69,10 @@ program
   .option('-W, --without <apps>', 'Exclude apps (comma-separated: app,web,widget)', (val) => val.split(','))
   .action(async (sessionId, options) => {
     const projectRoot = process.cwd();
-    const { loadConfig, getSessionDir } = await import('../dist/lib/config.js');
-    const docker = await import('../dist/lib/docker.js');
-
-    const config = await loadConfig(projectRoot);
-    const sessionDir = getSessionDir(config, projectRoot, sessionId);
-    let profiles;
-    if (options.mode === 'docker') {
-      const allApps = config.apps ?? ['app', 'web', 'widget'];
-      const excludeApps = options.without ?? [];
-      profiles = allApps.filter((app) => !excludeApps.includes(app));
-    }
-
-    await docker.up({ cwd: sessionDir, profiles });
+    await startSession(projectRoot, sessionId, {
+      mode: options.mode,
+      without: options.without,
+    });
   });
 
 program
@@ -128,18 +80,7 @@ program
   .description('Stop Docker services for a session (without destroying)')
   .action(async (sessionId) => {
     const projectRoot = process.cwd();
-    const { loadConfig, getSessionDir } = await import('../dist/lib/config.js');
-    const { execa } = await import('execa');
-
-    const config = await loadConfig(projectRoot);
-    const sessionDir = getSessionDir(config, projectRoot, sessionId);
-
-    // Use stop instead of down to preserve volumes
-    await execa(
-      'docker',
-      ['compose', '-f', 'docker-compose.session.yml', '--env-file', '.env.session', 'stop'],
-      { cwd: sessionDir, stdio: 'inherit' }
-    );
+    await stopSession(projectRoot, sessionId);
   });
 
 program
@@ -150,30 +91,11 @@ program
   .option('-n, --tail <lines>', 'Number of lines to show from the end', '50')
   .action(async (sessionId, options) => {
     const projectRoot = process.cwd();
-    const { loadConfig, getSessionDir } = await import('../dist/lib/config.js');
-    const { execa } = await import('execa');
-
-    const config = await loadConfig(projectRoot);
-    const sessionDir = getSessionDir(config, projectRoot, sessionId);
-    let profileFlags = [];
-    if (options.mode === 'docker') {
-      const allApps = config.apps ?? ['app', 'web', 'widget'];
-      const excludeApps = options.without ?? [];
-      const profiles = allApps.filter((app) => !excludeApps.includes(app));
-      profileFlags = profiles.flatMap((p) => ['--profile', p]);
-    }
-
-    const args = [
-      'compose',
-      '-f', 'docker-compose.session.yml',
-      '--env-file', '.env.session',
-      ...profileFlags,
-      'logs',
-      '-f',
-      '--tail', options.tail,
-    ];
-
-    await execa('docker', args, { cwd: sessionDir, stdio: 'inherit' });
+    await streamLogs(projectRoot, sessionId, {
+      mode: options.mode,
+      without: options.without,
+      tail: options.tail,
+    });
   });
 
 program
@@ -181,62 +103,7 @@ program
   .description('Stop all running sessions (preserves data)')
   .action(async () => {
     const projectRoot = process.cwd();
-    const chalk = (await import('chalk')).default;
-    const { loadConfig, getSessionDir } = await import('../dist/lib/config.js');
-    const { getSessionWorktrees } = await import('../dist/lib/worktree.js');
-    const docker = await import('../dist/lib/docker.js');
-    const { existsSync } = await import('node:fs');
-    const { resolve } = await import('node:path');
-
-    const config = await loadConfig(projectRoot);
-    const sessions = await getSessionWorktrees(projectRoot);
-
-    if (sessions.length === 0) {
-      console.log(chalk.gray('No sessions found.'));
-      return;
-    }
-
-    // Find running sessions
-    const runningSessions = [];
-    for (const session of sessions) {
-      const envFile = resolve(session.path, '.env.session');
-      if (existsSync(envFile)) {
-        const running = await docker.isRunning({ cwd: session.path });
-        if (running) {
-          runningSessions.push(session);
-        }
-      }
-    }
-
-    if (runningSessions.length === 0) {
-      console.log(chalk.gray('No running sessions found.'));
-      return;
-    }
-
-    console.log(chalk.blue(`Stopping ${runningSessions.length} running session(s)...\n`));
-
-    // Get all app profiles and service names to ensure we stop everything
-    const allApps = config.apps ?? ['app', 'web', 'widget'];
-    const profileFlags = allApps.flatMap((p) => ['--profile', p]);
-    // Explicitly list all services to stop (infrastructure + apps)
-    const allServices = ['postgres', 'mailpit', 'convas-app', 'convas-web', 'convas-widget'];
-
-    const { execa } = await import('execa');
-    for (const session of runningSessions) {
-      console.log(chalk.gray(`  Stopping session ${session.sessionId}...`));
-      try {
-        await execa(
-          'docker',
-          ['compose', '-f', 'docker-compose.session.yml', '--env-file', '.env.session', ...profileFlags, 'stop', ...allServices],
-          { cwd: session.path, stdio: 'pipe' }
-        );
-        console.log(chalk.green(`  Session ${session.sessionId} stopped.`));
-      } catch (error) {
-        console.log(chalk.yellow(`  Warning: Could not stop session ${session.sessionId}`));
-      }
-    }
-
-    console.log(chalk.green(`\nStopped ${runningSessions.length} session(s).`));
+    await stopAllSessions(projectRoot);
   });
 
 program
@@ -245,87 +112,7 @@ program
   .option('-y, --yes', 'Skip confirmation prompt')
   .action(async (options) => {
     const projectRoot = process.cwd();
-    const chalk = (await import('chalk')).default;
-    const { loadConfig } = await import('../dist/lib/config.js');
-    const { getSessionWorktrees, removeWorktree } = await import('../dist/lib/worktree.js');
-    const docker = await import('../dist/lib/docker.js');
-    const { existsSync } = await import('node:fs');
-    const { resolve } = await import('node:path');
-    const readline = await import('node:readline');
-
-    const config = await loadConfig(projectRoot);
-    const sessions = await getSessionWorktrees(projectRoot);
-
-    if (sessions.length === 0) {
-      console.log(chalk.gray('No sessions found.'));
-      return;
-    }
-
-    // Find stopped sessions
-    const stoppedSessions = [];
-    for (const session of sessions) {
-      const envFile = resolve(session.path, '.env.session');
-      let running = false;
-      if (existsSync(envFile)) {
-        running = await docker.isRunning({ cwd: session.path });
-      }
-      if (!running) {
-        stoppedSessions.push(session);
-      }
-    }
-
-    if (stoppedSessions.length === 0) {
-      console.log(chalk.gray('No stopped sessions to prune.'));
-      return;
-    }
-
-    console.log(chalk.yellow(`\nFound ${stoppedSessions.length} stopped session(s) to prune:`));
-    for (const session of stoppedSessions) {
-      console.log(chalk.gray(`  - Session ${session.sessionId} (${session.branch})`));
-    }
-    console.log('');
-
-    // Confirm unless --yes flag provided
-    if (!options.yes) {
-      const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-      });
-
-      const answer = await new Promise((resolve) => {
-        rl.question(chalk.red('Are you sure you want to delete these sessions? This cannot be undone. [y/N] '), resolve);
-      });
-      rl.close();
-
-      if (answer.toLowerCase() !== 'y' && answer.toLowerCase() !== 'yes') {
-        console.log(chalk.gray('Cancelled.'));
-        return;
-      }
-    }
-
-    console.log(chalk.blue('\nPruning stopped sessions...\n'));
-
-    for (const session of stoppedSessions) {
-      console.log(chalk.gray(`  Removing session ${session.sessionId}...`));
-      try {
-        // Clean up any docker resources
-        const envFile = resolve(session.path, '.env.session');
-        if (existsSync(envFile)) {
-          try {
-            await docker.down({ cwd: session.path });
-          } catch {
-            // Ignore errors - containers might already be removed
-          }
-        }
-        // Remove worktree and branch
-        await removeWorktree(projectRoot, session.path, session.branch);
-        console.log(chalk.green(`  Session ${session.sessionId} removed.`));
-      } catch (error) {
-        console.log(chalk.yellow(`  Warning: Could not fully remove session ${session.sessionId}`));
-      }
-    }
-
-    console.log(chalk.green(`\nPruned ${stoppedSessions.length} session(s).`));
+    await pruneSessions(projectRoot, { yes: options.yes });
   });
 
 program

package/dist/chunk-35SHBLIZ.js

@@ -0,0 +1,69 @@
+import {
+  calculatePorts
+} from "./chunk-PJKUD2N2.js";
+import {
+  getSessionWorktrees
+} from "./chunk-GWDGC2OE.js";
+import {
+  loadConfig
+} from "./chunk-25WQHUYW.js";
+import {
+  isRunning
+} from "./chunk-GBN67HYD.js";
+
+// src/commands/list.ts
+import { existsSync } from "fs";
+import { resolve } from "path";
+import chalk from "chalk";
+async function listSessions(projectRoot) {
+  const config = await loadConfig(projectRoot);
+  const sessions = await getSessionWorktrees(projectRoot);
+  if (sessions.length === 0) {
+    console.log(chalk.gray("No active sessions found."));
+    console.log(chalk.gray("\nTo create a session:"));
+    console.log(chalk.cyan("  dev-prism create"));
+    return;
+  }
+  console.log(chalk.blue("Active Sessions:"));
+  console.log(chalk.gray("================\n"));
+  for (const session of sessions) {
+    const status = await getSessionStatus(session.sessionId, session.path, session.branch, config);
+    printSessionStatus(status);
+  }
+}
+async function getSessionStatus(sessionId, path, branch, config) {
+  const ports = calculatePorts(config, sessionId);
+  let running = false;
+  const envFile = resolve(path, ".env.session");
+  if (existsSync(envFile)) {
+    running = await isRunning({ cwd: path });
+  }
+  return {
+    sessionId,
+    path,
+    branch,
+    running,
+    ports
+  };
+}
+function printSessionStatus(status) {
+  const statusIcon = status.running ? chalk.green("\u25CF") : chalk.red("\u25CB");
+  const statusText = status.running ? chalk.green("running") : chalk.gray("stopped");
+  console.log(`${statusIcon} Session ${chalk.bold(status.sessionId)} ${statusText}`);
+  console.log(chalk.gray(`  Path: ${status.path}`));
+  console.log(chalk.gray(`  Branch: ${status.branch}`));
+  console.log(chalk.gray("  Ports:"));
+  for (const [name, port] of Object.entries(status.ports)) {
+    const isApp = name.includes("APP") || name.includes("WEB") || name.includes("WIDGET");
+    if (isApp) {
+      console.log(chalk.gray(`    ${name}: http://localhost:${port}`));
+    } else {
+      console.log(chalk.gray(`    ${name}: ${port}`));
+    }
+  }
+  console.log("");
+}
+
+export {
+  listSessions
+};

package/dist/chunk-3ATDGV4Y.js

@@ -0,0 +1,22 @@
+// src/lib/ports.ts
+function calculatePorts(config, sessionId) {
+  const sessionNum = parseInt(sessionId, 10);
+  const basePort = config.portBase + sessionNum * 100;
+  const ports = {};
+  for (const [name, offset] of Object.entries(config.ports)) {
+    ports[name] = basePort + offset;
+  }
+  return ports;
+}
+function formatPortsTable(ports) {
+  const lines = [];
+  for (const [name, port] of Object.entries(ports)) {
+    lines.push(`  ${name}: http://localhost:${port}`);
+  }
+  return lines.join("\n");
+}
+
+export {
+  calculatePorts,
+  formatPortsTable
+};

package/dist/chunk-3MSC3CGG.js

@@ -0,0 +1,78 @@
+import {
+  removeWorktree
+} from "./chunk-Y3GR6XK7.js";
+import {
+  down
+} from "./chunk-GBN67HYD.js";
+import {
+  loadConfig
+} from "./chunk-25WQHUYW.js";
+import {
+  SessionStore
+} from "./chunk-6YMQTISJ.js";
+
+// src/commands/destroy.ts
+import { existsSync } from "fs";
+import { resolve } from "path";
+import chalk from "chalk";
+async function destroySession(projectRoot, sessionId, options) {
+  const config = await loadConfig(projectRoot);
+  const store = new SessionStore();
+  try {
+    if (options.all) {
+      console.log(chalk.blue("Destroying all sessions..."));
+      const sessions = store.listByProject(projectRoot);
+      if (sessions.length === 0) {
+        console.log(chalk.gray("No sessions found."));
+        return;
+      }
+      for (const session2 of sessions) {
+        await destroySingleSession(projectRoot, session2.session_id, session2.session_dir, session2.branch, session2.in_place === 1);
+        store.markDestroyed(projectRoot, session2.session_id);
+      }
+      console.log(chalk.green(`
+Destroyed ${sessions.length} session(s).`));
+      return;
+    }
+    if (!sessionId) {
+      console.error(chalk.red("Error: Session ID required. Use --all to destroy all sessions."));
+      process.exit(1);
+    }
+    if (!/^\d{3}$/.test(sessionId)) {
+      console.error(chalk.red("Error: Session ID must be exactly 3 digits (001-999)"));
+      process.exit(1);
+    }
+    const session = store.findSession(projectRoot, sessionId);
+    if (!session) {
+      console.error(chalk.red(`Error: Session ${sessionId} not found.`));
+      process.exit(1);
+    }
+    await destroySingleSession(projectRoot, sessionId, session.session_dir, session.branch, session.in_place === 1);
+    store.markDestroyed(projectRoot, sessionId);
+    console.log(chalk.green(`
+Session ${sessionId} destroyed.`));
+  } finally {
+    store.close();
+  }
+}
+async function destroySingleSession(projectRoot, sessionId, sessionDir, branchName, inPlace) {
+  console.log(chalk.blue(`
+Destroying session ${sessionId}...`));
+  const envFile = resolve(sessionDir, ".env.session");
+  if (existsSync(envFile)) {
+    console.log(chalk.gray("  Stopping Docker containers..."));
+    try {
+      await down({ cwd: sessionDir });
+    } catch {
+    }
+  }
+  if (!inPlace) {
+    console.log(chalk.gray("  Removing git worktree..."));
+    await removeWorktree(projectRoot, sessionDir, branchName);
+  }
+  console.log(chalk.green(`  Session ${sessionId} destroyed.`));
+}
+
+export {
+  destroySession
+};