create-walle 0.1.1 → 0.2.0

package/bin/create-walle.js

@@ -1,134 +1,349 @@
 #!/usr/bin/env node
 'use strict';
 
-const { execFileSync } = require('child_process');
+const { execFileSync, execFile, spawn } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 
 const BOLD = '\x1b[1m';
 const DIM = '\x1b[2m';
 const GREEN = '\x1b[32m';
+const RED = '\x1b[31m';
 const CYAN = '\x1b[36m';
 const RESET = '\x1b[0m';
 
-// Template directory bundled inside this npm package
 const TEMPLATE_DIR = path.join(__dirname, '..', 'template');
+const LABEL = 'com.walle.server';
 
-function detectName() {
-  try { return execFileSync('git', ['config', 'user.name'], { encoding: 'utf8' }).trim(); } catch {}
-  try { return execFileSync('id', ['-F'], { encoding: 'utf8' }).trim(); } catch {} // macOS full name
-  return process.env.USER || 'Owner';
-}
+// ── CLI Router ──
 
-function detectTimezone() {
-  try { return Intl.DateTimeFormat().resolvedOptions().timeZone; } catch {}
-  return 'UTC';
+const command = process.argv[2] || '';
+
+if (command === 'install') {
+  install(process.argv[3]);
+} else if (command === 'start') {
+  start();
+} else if (command === 'stop') {
+  stop();
+} else if (command === 'status') {
+  status();
+} else if (command === 'logs') {
+  logs();
+} else if (command === 'uninstall') {
+  uninstall();
+} else if (command === '--help' || command === '-h' || command === 'help') {
+  usage();
+} else if (command && !command.startsWith('-')) {
+  // Backwards compat: bare directory name = install
+  install(command);
+} else {
+  usage();
 }
 
-function copyRecursive(src, dest) {
-  const stat = fs.statSync(src);
-  if (stat.isDirectory()) {
-    fs.mkdirSync(dest, { recursive: true });
-    for (const entry of fs.readdirSync(src)) {
-      if (entry === 'node_modules' || entry === '.git') continue;
-      copyRecursive(path.join(src, entry), path.join(dest, entry));
-    }
-  } else {
-    fs.copyFileSync(src, dest);
-  }
+// ── Commands ──
+
+function usage() {
+  console.log(`
+${BOLD}${CYAN}  Wall-E${RESET} — Your personal digital twin
+
+  ${BOLD}Usage:${RESET}
+
+    ${BOLD}npx create-walle install <directory>${RESET}  Install Wall-E and start the service
+    ${BOLD}npx create-walle start${RESET}               Start Wall-E (auto-restarts on reboot)
+    ${BOLD}npx create-walle stop${RESET}                Stop Wall-E
+    ${BOLD}npx create-walle status${RESET}              Check if Wall-E is running
+    ${BOLD}npx create-walle logs${RESET}                Tail the service logs
+    ${BOLD}npx create-walle uninstall${RESET}           Remove the auto-start service
+
+  ${DIM}Run 'start' and 'stop' from inside your Wall-E directory,
+  or set WALLE_DIR to point to it.${RESET}
+`);
 }
 
-async function main() {
-  const targetDir = process.argv[2] || 'walle';
+function install(targetDir) {
+  if (!targetDir) {
+    console.log(`\n  ${RED}Missing directory name.${RESET} Usage: npx create-walle install ./my-agent\n`);
+    process.exit(1);
+  }
 
-  console.log(`\n${BOLD}${CYAN}  Wall-E${RESET} — Your personal digital twin\n`);
+  console.log(`\n${BOLD}${CYAN}  Wall-E${RESET} — Installing...\n`);
 
   if (fs.existsSync(targetDir)) {
-    console.log(`  Directory "${targetDir}" already exists. Choose a different name:\n    npx create-walle my-agent\n`);
+    console.log(`  ${RED}Directory "${targetDir}" already exists.${RESET}\n`);
     process.exit(1);
   }
-
   if (!fs.existsSync(TEMPLATE_DIR)) {
-    console.error('  Template directory not found. Try: npm cache clean --force && npx create-walle@latest');
+    console.error('  Template not found. Try: npm cache clean --force && npx create-walle@latest');
     process.exit(1);
   }
 
-  // Auto-detect owner info (strip chars that would break .env)
+  // Auto-detect
   const ownerName = detectName().replace(/[\r\n=]/g, '').trim().slice(0, 200);
   const timezone = detectTimezone();
   const nameParts = ownerName.split(/\s+/);
+  const port = process.env.WALLE_PORT || '4567';
 
   console.log(`  ${DIM}Owner:    ${ownerName}${RESET}`);
   console.log(`  ${DIM}Timezone: ${timezone}${RESET}`);
+  console.log(`  ${DIM}Port:     ${port}${RESET}`);
 
   // Copy template
   console.log(`\n  Copying files...`);
   copyRecursive(TEMPLATE_DIR, targetDir);
 
-  // Install dependencies
+  // Install deps
   console.log(`  Installing dependencies...\n`);
   try {
     execFileSync('npm', ['install', '--loglevel=warn'], { cwd: path.join(targetDir, 'claude-task-manager'), stdio: 'inherit' });
     execFileSync('npm', ['install', '--loglevel=warn'], { cwd: path.join(targetDir, 'wall-e'), stdio: 'inherit' });
-  } catch (e) {
-    console.error(`\n  Failed to install dependencies. Make sure npm is installed and try:\n    cd ${targetDir}/claude-task-manager && npm install\n    cd ${targetDir}/wall-e && npm install\n`);
+  } catch {
+    console.error(`\n  ${RED}npm install failed.${RESET} Try manually:\n    cd ${targetDir}/claude-task-manager && npm install\n    cd ${targetDir}/wall-e && npm install\n`);
     process.exit(1);
   }
 
-  // Create .env (API key left as placeholder — configured via web UI)
+  // .env
   const envLines = [
     `# Wall-E configuration — generated ${new Date().toISOString().split('T')[0]}`,
-    `# Add your API key below, or configure it at http://localhost:3456/setup`,
+    `# Finish setup at http://localhost:${port}/setup.html`,
     '',
     `WALLE_OWNER_NAME=${ownerName}`,
     '# ANTHROPIC_API_KEY=sk-ant-...',
     '',
-    '# Slack (connect via http://localhost:3456/#walle → Settings)',
+    `CTM_PORT=${port}`,
+    '',
     '# SLACK_TOKEN=',
     '# SLACK_OWNER_USER_ID=',
     '# SLACK_OWNER_HANDLE=',
   ];
   fs.writeFileSync(path.join(targetDir, '.env'), envLines.join('\n') + '\n', { mode: 0o600 });
 
-  // Create wall-e-config.json
-  const walleConfig = {
-    owner: {
-      name: ownerName,
-      first_name: nameParts[0],
-      last_name: nameParts.slice(1).join(' '),
-      timezone,
-    },
-    adapters: { ctm: { enabled: true }, slack: { enabled: false } },
-    intervals: { ingest_ms: 60000, think_ms: 120000 },
-  };
+  // wall-e-config.json
   fs.writeFileSync(
     path.join(targetDir, 'wall-e', 'wall-e-config.json'),
-    JSON.stringify(walleConfig, null, 2) + '\n',
+    JSON.stringify({
+      owner: { name: ownerName, first_name: nameParts[0], last_name: nameParts.slice(1).join(' '), timezone },
+      adapters: { ctm: { enabled: true }, slack: { enabled: false } },
+      intervals: { ingest_ms: 60000, think_ms: 120000 },
+    }, null, 2) + '\n',
     { mode: 0o600 }
   );
 
-  // Create data directory
-  const dataDir = path.join(process.env.HOME, '.walle', 'data');
-  fs.mkdirSync(dataDir, { recursive: true });
+  // Data dir
+  fs.mkdirSync(path.join(process.env.HOME, '.walle', 'data'), { recursive: true });
 
-  // Init git repo
-  execFileSync('git', ['init', '-q'], { cwd: targetDir, stdio: 'ignore' });
+  // Git init
+  try { execFileSync('git', ['init', '-q'], { cwd: targetDir, stdio: 'ignore' }); } catch {}
+
+  // Save install path for start/stop
+  saveWalleDir(path.resolve(targetDir));
+
+  // Install and start the service
+  console.log(`\n  Starting Wall-E service...`);
+  installService(path.resolve(targetDir), port);
 
   console.log(`
-  ${GREEN}${BOLD}Done!${RESET}
+  ${GREEN}${BOLD}Wall-E is running!${RESET}
 
-  ${BOLD}1. Start:${RESET}
-     cd ${targetDir} && node claude-task-manager/server.js
+  ${BOLD}Open:${RESET}  http://localhost:${port}
 
-  ${BOLD}2. Open:${RESET}
-     http://localhost:3456
+  ${BOLD}Manage:${RESET}
+    npx create-walle stop       ${DIM}Stop the service${RESET}
+    npx create-walle start      ${DIM}Start / restart${RESET}
+    npx create-walle status     ${DIM}Check status${RESET}
+    npx create-walle logs       ${DIM}View logs${RESET}
 
-  ${BOLD}3. Finish setup in the browser:${RESET}
-     Add your Anthropic API key and connect integrations.
+  ${BOLD}Change port:${RESET}
+    Edit ${targetDir}/.env → CTM_PORT=8080
+    npx create-walle start
 `);
 }
 
-main().catch(err => {
-  console.error(`  Error: ${err.message}`);
+function start() {
+  const dir = findWalleDir();
+  const port = readPort(dir);
+
+  console.log(`\n  Starting Wall-E from ${DIM}${dir}${RESET} on port ${port}...`);
+  installService(dir, port);
+  console.log(`  ${GREEN}Running!${RESET}  http://localhost:${port}\n`);
+}
+
+function stop() {
+  const plist = path.join(process.env.HOME, 'Library', 'LaunchAgents', `${LABEL}.plist`);
+  if (process.platform === 'darwin' && fs.existsSync(plist)) {
+    try { execFileSync('launchctl', ['unload', plist], { stdio: 'ignore' }); } catch {}
+    console.log(`\n  ${GREEN}Wall-E stopped.${RESET}`);
+    console.log(`  Run ${BOLD}npx create-walle start${RESET} to restart.\n`);
+  } else {
+    // Fallback: try killing the process
+    try {
+      const dir = findWalleDir();
+      const port = readPort(dir);
+      execFileSync('curl', ['-sX', 'POST', `http://localhost:${port}/api/stop/walle`], { timeout: 3000 });
+    } catch {}
+    console.log(`\n  Stopped (or was not running).\n`);
+  }
+}
+
+function status() {
+  const dir = findWalleDir();
+  const port = readPort(dir);
+  try {
+    const result = execFileSync('curl', ['-s', `http://localhost:${port}/api/services/status`], { encoding: 'utf8', timeout: 3000 });
+    const data = JSON.parse(result);
+    console.log(`\n  ${GREEN}${BOLD}Wall-E is running${RESET} on port ${port}`);
+    console.log(`  ${DIM}CTM:    PID ${data.ctm?.pid || '?'}, uptime ${Math.round((data.ctm?.uptime || 0) / 60)}m${RESET}`);
+    console.log(`  ${DIM}Wall-E: PID ${data.walle?.pid || '?'}${RESET}`);
+    console.log(`  ${DIM}Dir:    ${dir}${RESET}\n`);
+  } catch {
+    console.log(`\n  ${RED}Wall-E is not running${RESET} (port ${port})`);
+    console.log(`  Run ${BOLD}npx create-walle start${RESET} to start.\n`);
+  }
+}
+
+function logs() {
+  const logFile = path.join(process.env.HOME, '.walle', 'logs', 'walle.log');
+  if (!fs.existsSync(logFile)) {
+    console.log(`\n  No logs yet at ${logFile}\n`);
+    return;
+  }
+  const child = spawn('tail', ['-f', logFile], { stdio: 'inherit' });
+  child.on('error', () => console.log(`  Could not tail ${logFile}`));
+}
+
+function uninstall() {
+  const plist = path.join(process.env.HOME, 'Library', 'LaunchAgents', `${LABEL}.plist`);
+  try { execFileSync('launchctl', ['unload', plist], { stdio: 'ignore' }); } catch {}
+  try { fs.unlinkSync(plist); } catch {}
+  try { fs.unlinkSync(path.join(process.env.HOME, '.walle', 'install-path')); } catch {}
+  console.log(`\n  ${GREEN}Service uninstalled.${RESET} Your data in ~/.walle/data is preserved.\n`);
+}
+
+// ── Service Management ──
+
+function installService(walleDir, port) {
+  const logDir = path.join(process.env.HOME, '.walle', 'logs');
+  fs.mkdirSync(logDir, { recursive: true });
+
+  if (process.platform === 'darwin') {
+    const nodePath = process.execPath;
+    const plistDir = path.join(process.env.HOME, 'Library', 'LaunchAgents');
+    fs.mkdirSync(plistDir, { recursive: true });
+    const plistPath = path.join(plistDir, `${LABEL}.plist`);
+
+    // Build env vars from .env file
+    let envDict = `    <key>PATH</key>\n    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>\n`;
+    envDict += `    <key>HOME</key>\n    <string>${process.env.HOME}</string>\n`;
+    envDict += `    <key>CTM_PORT</key>\n    <string>${port}</string>\n`;
+    try {
+      const envFile = fs.readFileSync(path.join(walleDir, '.env'), 'utf8');
+      for (const line of envFile.split('\n')) {
+        const m = line.match(/^\s*([^#=\s]+)\s*=\s*(.+?)\s*$/);
+        if (m && m[1] !== 'CTM_PORT' && m[1] !== 'PATH' && m[1] !== 'HOME') {
+          envDict += `    <key>${m[1]}</key>\n    <string>${m[2]}</string>\n`;
+        }
+      }
+    } catch {}
+
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${nodePath}</string>
+    <string>${walleDir}/claude-task-manager/server.js</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${walleDir}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+${envDict}  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${logDir}/walle.log</string>
+  <key>StandardErrorPath</key>
+  <string>${logDir}/walle.err</string>
+</dict>
+</plist>`;
+
+    fs.writeFileSync(plistPath, plist);
+    try { execFileSync('launchctl', ['unload', plistPath], { stdio: 'ignore' }); } catch {}
+    execFileSync('launchctl', ['load', plistPath]);
+  } else {
+    // Linux/other: just start directly in background
+    const child = spawn('node', ['claude-task-manager/server.js'], {
+      cwd: walleDir,
+      detached: true,
+      stdio: ['ignore', fs.openSync(path.join(logDir, 'walle.log'), 'a'), fs.openSync(path.join(logDir, 'walle.err'), 'a')],
+      env: { ...process.env, CTM_PORT: port },
+    });
+    child.unref();
+    fs.writeFileSync(path.join(logDir, 'walle.pid'), String(child.pid));
+  }
+}
+
+// ── Helpers ──
+
+function saveWalleDir(dir) {
+  const metaDir = path.join(process.env.HOME, '.walle');
+  fs.mkdirSync(metaDir, { recursive: true });
+  fs.writeFileSync(path.join(metaDir, 'install-path'), dir + '\n');
+}
+
+function findWalleDir() {
+  // 1. WALLE_DIR env
+  if (process.env.WALLE_DIR && fs.existsSync(path.join(process.env.WALLE_DIR, 'claude-task-manager'))) {
+    return process.env.WALLE_DIR;
+  }
+  // 2. Current directory
+  if (fs.existsSync(path.join(process.cwd(), 'claude-task-manager', 'server.js'))) {
+    return process.cwd();
+  }
+  // 3. Saved install path
+  const saved = path.join(process.env.HOME, '.walle', 'install-path');
+  if (fs.existsSync(saved)) {
+    const dir = fs.readFileSync(saved, 'utf8').trim();
+    if (fs.existsSync(path.join(dir, 'claude-task-manager', 'server.js'))) return dir;
+  }
+  console.error(`\n  ${RED}Can't find Wall-E installation.${RESET}`);
+  console.error(`  Run from inside the Wall-E directory, or set WALLE_DIR.\n`);
   process.exit(1);
-});
+}
+
+function readPort(dir) {
+  try {
+    const env = fs.readFileSync(path.join(dir, '.env'), 'utf8');
+    const m = env.match(/^CTM_PORT=(\d+)/m);
+    if (m) return m[1];
+  } catch {}
+  return '4567';
+}
+
+function detectName() {
+  try { return execFileSync('git', ['config', 'user.name'], { encoding: 'utf8' }).trim(); } catch {}
+  try { return execFileSync('id', ['-F'], { encoding: 'utf8' }).trim(); } catch {}
+  return process.env.USER || 'Owner';
+}
+
+function detectTimezone() {
+  try { return Intl.DateTimeFormat().resolvedOptions().timeZone; } catch {}
+  return 'UTC';
+}
+
+function copyRecursive(src, dest) {
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src)) {
+      if (entry === 'node_modules' || entry === '.git') continue;
+      copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-walle",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Set up Wall-E — your personal digital twin",
   "bin": {
     "create-walle": "bin/create-walle.js"

package/template/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+## 0.1.1 (2026-04-02)
+
+### Fixed
+- Remove personal name from SKILL.md author fields and spec docs
+- Deprecate npm 0.1.0 (contained personal data in author fields)
+
+## 0.1.0 (2026-04-02)
+
+### Added
+- **Browser-based setup wizard** — auto-detects owner name from `git config` and timezone from system; first visit redirects to `/setup.html` for API key and Slack OAuth
+- **`npx create-walle` scaffolder** — zero-prompt install with bundled template
+- **Documentation site** — quickstart, configuration, Claude Code integration, skill catalog, API reference
+- **README.md** — architecture diagram, quickstart, config table, API overview
+- **Claude Code skill registry** — `claude-code-skill.md` for MCP server integration
+- **Security hardening** — input validation on setup save, .env injection protection, body size limits, API key format checks, cached `needsSetup()`
+
+### Changed
+- Replaced all hardcoded personal data with env vars (`SLACK_OWNER_USER_ID`, `SLACK_OWNER_HANDLE`, `WALLE_OWNER_NAME`)
+- Default data directory changed from `~/Dropbox/...` to `~/.walle/data`
+- Genericized test data (personal names replaced with `Test Owner`/`TestUser`)
+- Git history scrubbed of sensitive strings via `filter-branch`
+
+## Pre-release (2026-01 to 2026-04)
+
+### Wall-E Agent
+- **Phase 5** — Cloud deployment (Dockerfile, Fly.io, HTTP server)
+- **Phase 4** — iMessage channel, Slack DM, agent-to-agent protocol
+- **Phase 3** — Chat interface with tool-use, confidence scoring, actions UI
+- **Phase 2** — Contradiction detection, reflect loop, knowledge extraction
+- **Phase 1** — Brain DB (SQLite), adapters, ingest + think loops
+- **Slack integration** — 20,933 messages ingested (2022-2026), backfill + incremental sync
+- **Skills system** — 7 bundled skills (calendar, Slack, email, morning briefing, memory search)
+- **MCP client** — Call Slack, SendGrid, and any MCP server from skills
+- **Chat persistence** — Conversation history stored in brain DB
+
+### Claude Task Manager (CTM)
+- Terminal multiplexer for Claude Code sessions
+- Rich-text prompt editor with versioning, folders, composite prompts
+- Code review module with diff viewer and inline comments
+- AI-powered session search and analysis
+- Permission manager with natural language rules
+- Task dashboard with recurring tasks and live logs

package/template/bin/github-polish.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Run this after authenticating gh as the ShanniLi account:
+#   gh auth login
+# Or manually set these in GitHub Settings > General
+
+gh repo edit ShanniLi/tools \
+  --description "Wall-E — your personal digital twin. AI agent that learns from Slack, email & calendar. Includes CTM dashboard." \
+  --homepage "https://walle.sh" \
+  --add-topic "ai" \
+  --add-topic "digital-twin" \
+  --add-topic "claude" \
+  --add-topic "personal-assistant" \
+  --add-topic "slack" \
+  --add-topic "sqlite" \
+  --add-topic "nodejs"
+
+echo "Done. Set social preview image manually at:"
+echo "  https://github.com/ShanniLi/tools/settings"

package/template/bin/install-service.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+# Install Wall-E as a macOS Launch Agent so it starts automatically on login.
+# Usage: bash bin/install-service.sh [--uninstall]
+
+set -e
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(dirname "$SCRIPT_DIR")"
+LABEL="com.walle.server"
+PLIST="$HOME/Library/LaunchAgents/$LABEL.plist"
+PORT="${CTM_PORT:-4567}"
+
+if [[ "$1" == "--uninstall" ]]; then
+  launchctl unload "$PLIST" 2>/dev/null || true
+  rm -f "$PLIST"
+  echo "Wall-E service uninstalled."
+  exit 0
+fi
+
+# Source .env to get the port
+if [[ -f "$ROOT/.env" ]]; then
+  export $(grep -v '^#' "$ROOT/.env" | grep '=' | xargs)
+  PORT="${CTM_PORT:-4567}"
+fi
+
+NODE=$(which node)
+LOG_DIR="$HOME/.walle/logs"
+mkdir -p "$LOG_DIR"
+
+cat > "$PLIST" << EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>$LABEL</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>$NODE</string>
+    <string>$ROOT/claude-task-manager/server.js</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>$ROOT</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+    <key>HOME</key>
+    <string>$HOME</string>
+    <key>CTM_PORT</key>
+    <string>$PORT</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>$LOG_DIR/walle.log</string>
+  <key>StandardErrorPath</key>
+  <string>$LOG_DIR/walle.err</string>
+</dict>
+</plist>
+EOF
+
+launchctl unload "$PLIST" 2>/dev/null || true
+launchctl load "$PLIST"
+
+echo "Wall-E installed as a macOS service."
+echo ""
+echo "  Status:    launchctl list | grep walle"
+echo "  Logs:      tail -f ~/.walle/logs/walle.log"
+echo "  Dashboard: http://localhost:$PORT"
+echo "  Uninstall: bash bin/install-service.sh --uninstall"

package/template/claude-task-manager/public/css/walle.css

@@ -408,23 +408,24 @@
 
 /* Markdown rendered output */
 .we-task-output-md {
-  padding: 10px 14px;
+  padding: 12px 16px;
   overflow-y: auto;
-  max-height: 500px;
+  max-height: 600px;
 }
 .we-task-md {
   font-size: 13px; line-height: 1.6; color: #ccc;
 }
 .we-task-md h1, .we-task-md h2, .we-task-md h3 {
-  color: #e2e8f0; margin: 12px 0 6px; font-weight: 600;
+  color: #e2e8f0; font-weight: 600;
 }
-.we-task-md h1 { font-size: 16px; border-bottom: 1px solid rgba(255,255,255,0.08); padding-bottom: 4px; }
-.we-task-md h2 { font-size: 14px; }
-.we-task-md h3 { font-size: 13px; color: #94a3b8; }
+.we-task-md h1 { font-size: 17px; border-bottom: 1px solid rgba(255,255,255,0.08); padding-bottom: 6px; margin: 16px 0 10px; }
+.we-task-md h2 { font-size: 14px; margin: 18px 0 8px; color: #93c5fd; }
+.we-task-md h3 { font-size: 13px; color: #94a3b8; margin: 12px 0 6px; }
 .we-task-md p { margin: 6px 0; }
 .we-task-md ul, .we-task-md ol { margin: 6px 0; padding-left: 20px; }
-.we-task-md li { margin: 3px 0; }
-.we-task-md li::marker { color: #555; }
+.we-task-md li { margin: 4px 0; line-height: 1.55; }
+.we-task-md li::marker { color: #444; }
+.we-task-md li strong { color: #93c5fd; }
 .we-task-md code {
   font-family: 'SF Mono', 'Menlo', 'Monaco', monospace;
   font-size: 12px; background: rgba(255,255,255,0.06);

package/template/claude-task-manager/public/index.html

@@ -2239,6 +2239,7 @@
       <button class="nav-pill" data-nav="codereview" onclick="navTo('codereview')" title="Code Review">Review</button>
       <button class="nav-pill" data-nav="walle" onclick="navTo('walle')" title="WALL-E Agent">WALL-E</button>
       <button class="nav-pill" data-nav="rules" onclick="navTo('rules')" title="Edit CLAUDE.md rules">Rules</button>
+      <a href="/setup.html" class="nav-pill" title="Setup & Settings" style="text-decoration:none;margin-left:auto;font-size:16px;padding:4px 8px;">⚙</a>
     </nav>
     <div class="topbar-right">
       <span id="topbar-context-btns"></span>

package/template/claude-task-manager/public/setup.html

@@ -74,6 +74,7 @@
       </div>
       <div class="btn-row">
         <button class="btn btn-primary" id="save-btn" onclick="saveConfig()">Save & Continue</button>
+        <button class="btn btn-secondary" id="detect-btn" onclick="detectKey()" title="Check your shell environment for an existing API key">Detect from environment</button>
         <span class="success-msg" id="save-ok">Saved!</span>
         <span class="error-msg" id="save-err"></span>
       </div>
@@ -120,7 +121,8 @@
 
     <!-- Done -->
     <div class="done-section">
-      <a href="/" id="done-link">Go to Dashboard →</a>
+      <a href="/index.html" id="done-link">Go to Dashboard →</a>
+      <div style="margin-top:8px;font-size:12px;color:var(--dim)">You can return to this page anytime from the settings icon in the nav bar.</div>
     </div>
   </div>
 
@@ -210,6 +212,41 @@
       }
     }
 
+    async function detectKey() {
+      const btn = document.getElementById('detect-btn');
+      const errMsg = document.getElementById('save-err');
+      const okMsg = document.getElementById('save-ok');
+      errMsg.style.display = 'none';
+      okMsg.style.display = 'none';
+      btn.disabled = true;
+      btn.textContent = 'Checking...';
+      try {
+        const r = await fetch('/api/setup/detect-key');
+        const d = await r.json();
+        if (d.found) {
+          document.getElementById('api-key').value = '';
+          document.getElementById('api-key').placeholder = '••••••••••••••• (from ' + (d.source || 'environment') + ')';
+          document.getElementById('api-dot').className = 'status-dot ok';
+          okMsg.textContent = 'API key detected from ' + (d.source || 'environment') + '!';
+          okMsg.style.display = 'inline';
+          const ownerVal = document.getElementById('owner-name').value.trim();
+          await fetch('/api/setup/save', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ owner_name: ownerVal, api_key: d.key }),
+          });
+        } else {
+          errMsg.textContent = d.hint || 'No API key found. Enter one manually.';
+          errMsg.style.display = 'inline';
+        }
+      } catch (e) {
+        errMsg.textContent = e.message;
+        errMsg.style.display = 'inline';
+      }
+      btn.textContent = 'Detect from environment';
+      btn.disabled = false;
+    }
+
     loadStatus();
   </script>
 </body>