create-walle 0.1.0 → 0.2.0

package/template/claude-task-manager/server.js

@@ -144,6 +144,7 @@ const server = http.createServer((req, res) => {
   }
 
   // Redirect to setup page on first run (no API key configured)
+  // Only redirect root `/` — allow direct `/index.html` access so "Go to Dashboard" always works
   if (url.pathname === '/' && setup.needsSetup()) {
     res.writeHead(302, { 'Location': '/setup.html' });
     res.end();
@@ -203,6 +204,64 @@ function handleApi(req, res, url) {
     res.end(JSON.stringify({ owner_name: ownerName, has_api_key: hasApiKey, slack_connected: slackConnected, needs_setup: setup.needsSetup() }));
     return;
   }
+  if (url.pathname === '/api/setup/detect-key' && req.method === 'GET') {
+    let key = '';
+    let source = '';
+
+    // 1. Check process.env
+    if (process.env.ANTHROPIC_API_KEY && process.env.ANTHROPIC_API_KEY.startsWith('sk-ant-')) {
+      key = process.env.ANTHROPIC_API_KEY;
+      source = 'environment variable';
+    }
+
+    // 2. Try shell profile
+    if (!key) {
+      try {
+        const { execFileSync } = require('child_process');
+        const shell = process.env.SHELL || '/bin/zsh';
+        const result = execFileSync(shell, ['-ilc', 'echo $ANTHROPIC_API_KEY'], { encoding: 'utf8', timeout: 3000 }).trim();
+        if (result && result.startsWith('sk-ant-')) { key = result; source = 'shell profile'; }
+      } catch {}
+    }
+
+    // 3. Try Claude Code OAuth token from macOS Keychain
+    if (!key && process.platform === 'darwin') {
+      try {
+        const { execFileSync } = require('child_process');
+        const credJson = execFileSync('security', ['find-generic-password', '-s', 'Claude Code-credentials', '-w'], { encoding: 'utf8', timeout: 3000 }).trim();
+        if (credJson) {
+          const cred = JSON.parse(credJson);
+          const oauth = cred.claudeAiOauth;
+          if (oauth && oauth.accessToken) {
+            const expired = oauth.expiresAt && oauth.expiresAt < Date.now();
+            if (!expired) {
+              key = oauth.accessToken;
+              source = 'Claude Code (OAuth)';
+            } else {
+              // Token expired — tell user to refresh
+              res.writeHead(200, { 'Content-Type': 'application/json' });
+              res.end(JSON.stringify({
+                found: false,
+                claude_code_expired: true,
+                hint: 'Found Claude Code, but the OAuth token has expired. Run "claude" in your terminal once to refresh it, then click Detect again.'
+              }));
+              return;
+            }
+          }
+        }
+      } catch {}
+    }
+
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    if (key) {
+      res.end(JSON.stringify({ found: true, key, source }));
+    } else if (process.env.ANTHROPIC_BASE_URL) {
+      res.end(JSON.stringify({ found: false, hint: 'Your environment uses an API gateway (' + process.env.ANTHROPIC_BASE_URL + '). You may not need a separate API key — try going to the dashboard.' }));
+    } else {
+      res.end(JSON.stringify({ found: false, hint: 'No API key found. Checked: environment variables, shell profile, Claude Code keychain. You can get a key at console.anthropic.com' }));
+    }
+    return;
+  }
   if (url.pathname === '/api/setup/save' && req.method === 'POST') {
     let body = '';
     let bodyLen = 0;

package/template/docs/site/astro.config.mjs

@@ -0,0 +1,28 @@
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+export default defineConfig({
+  site: 'https://walle.sh',
+  integrations: [
+    starlight({
+      title: 'Wall-E',
+      description: 'Your personal digital twin — documentation',
+      social: {
+        github: 'https://github.com/ShanniLi/tools',
+      },
+      sidebar: [
+        {
+          label: 'Getting Started',
+          autogenerate: { directory: 'guides' },
+        },
+        {
+          label: 'Reference',
+          items: [
+            { label: 'Skills', link: '/skills/' },
+            { label: 'API', link: '/api/' },
+          ],
+        },
+      ],
+    }),
+  ],
+});

package/template/docs/site/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "walle-docs",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview"
+  },
+  "dependencies": {
+    "@astrojs/starlight": "0.32.5",
+    "astro": "5.4.2",
+    "sharp": "^0.33.0"
+  },
+  "overrides": {
+    "@astrojs/sitemap": "3.3.0",
+    "zod-to-json-schema": "3.24.5"
+  }
+}

package/template/docs/site/src/content/docs/api.md

@@ -0,0 +1,189 @@
+---
+title: API Reference
+---
+
+CTM serves all APIs on port 3456. Wall-E APIs are proxied through CTM at `/api/wall-e/*`.
+
+## Service Management
+
+| Method | Path | Description |
+|---|---|---|
+| GET | `/api/services/status` | Returns running status and PIDs of CTM and Wall-E |
+| POST | `/api/restart/ctm` | Restart the CTM server |
+| POST | `/api/restart/walle` | Restart the Wall-E daemon |
+| POST | `/api/start/walle` | Start the Wall-E daemon |
+| POST | `/api/stop/walle` | Stop the Wall-E daemon |
+
+### Example
+
+```bash
+curl -s http://localhost:3456/api/services/status
+# {"ctm":{"running":true,"pid":1234,"uptime":3600},"walle":{"running":true,"pid":5678}}
+```
+
+---
+
+## Wall-E Brain
+
+### GET /api/wall-e/status
+
+Returns brain stats, owner info, and memory counts.
+
+### GET /api/wall-e/memories
+
+List memories with optional filters.
+
+**Query params:**
+- `source` — filter by source (`slack`, `calendar`, `email`, `ctm`)
+- `since` — ISO 8601 timestamp, return memories after this time
+- `limit` — max results (default: 50)
+- `offset` — pagination offset
+
+### GET /api/wall-e/knowledge
+
+List knowledge entries.
+
+**Query params:**
+- `category` — filter by category
+- `subject` — filter by subject
+- `status` — filter by status (`active`, `superseded`, `retracted`)
+- `limit`, `offset` — pagination
+
+### GET /api/wall-e/people
+
+List known people with relationship and trust info.
+
+### GET /api/wall-e/timeline
+
+Memory timeline ordered by timestamp DESC.
+
+**Query params:**
+- `limit` (default: 50)
+- `offset`
+
+### GET /api/wall-e/questions
+
+List pending questions.
+
+**Query params:**
+- `status` — `pending`, `answered`, `inferred`
+- `limit`
+
+### GET /api/wall-e/brief
+
+Get the latest daily briefing summary.
+
+### POST /api/wall-e/chat
+
+Send a message to Wall-E and get a response.
+
+**Body:**
+```json
+{
+  "message": "What meetings do I have tomorrow?",
+  "channel": "ctm"
+}
+```
+
+**Response:**
+```json
+{
+  "reply": "You have 3 meetings tomorrow...",
+  "tool_calls": []
+}
+```
+
+### GET /api/wall-e/stats
+
+Brain statistics — memory counts by source, knowledge counts, people count.
+
+---
+
+## Sessions
+
+### GET /api/sessions
+
+List active terminal sessions.
+
+### WebSocket: ws://localhost:2001
+
+Real-time terminal I/O for sessions. Messages:
+
+- `{"type":"create","id":"uuid","cmd":"claude","label":"My Session"}` — create session
+- `{"type":"input","id":"uuid","data":"text"}` — send input
+- `{"type":"resize","id":"uuid","cols":80,"rows":24}` — resize terminal
+- `{"type":"kill","id":"uuid"}` — kill session
+
+---
+
+## Prompts
+
+### GET /api/prompts
+
+List all prompts. Supports query params: `folder`, `starred`, `tag`, `search`.
+
+### GET /api/prompts/:id
+
+Get a single prompt with content, tags, and metadata.
+
+### POST /api/prompts
+
+Create a new prompt.
+
+**Body:**
+```json
+{
+  "title": "My Prompt",
+  "content": "Prompt content here",
+  "content_html": "<p>Prompt content here</p>",
+  "tags": "[\"tag1\",\"tag2\"]",
+  "context_type": "general"
+}
+```
+
+### PUT /api/prompts/:id
+
+Update a prompt.
+
+### DELETE /api/prompts/:id
+
+Delete a prompt.
+
+### GET /api/prompts/:id/children
+
+Get child prompts of a group/composite prompt.
+
+### POST /api/prompts/:id/versions
+
+Create a version snapshot of a prompt.
+
+---
+
+## Tasks
+
+### GET /api/tasks
+
+List tasks. Supports query params: `status`, `type`, `skill`.
+
+### POST /api/tasks
+
+Create a task.
+
+**Body:**
+```json
+{
+  "title": "Sync Calendar",
+  "type": "recurring",
+  "schedule": "every 30m",
+  "skill": "google-calendar",
+  "skill_config": "{\"days_back\":1,\"days_ahead\":14}"
+}
+```
+
+### PUT /api/tasks/:id
+
+Update a task (status, schedule, config).
+
+### DELETE /api/tasks/:id
+
+Delete a task.

package/template/docs/site/src/content/docs/guides/claude-code.md

@@ -0,0 +1,62 @@
+---
+sidebar:
+  order: 3
+title: Claude Code Integration
+---
+
+Wall-E can be used as an MCP server from Claude Code, giving Claude access to your personal knowledge base.
+
+## Setup
+
+Add Wall-E to your Claude Code MCP config (`~/.claude/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "wall-e": {
+      "type": "http",
+      "url": "http://localhost:3457/mcp"
+    }
+  }
+}
+```
+
+Start Wall-E's standalone HTTP server:
+
+```bash
+cd wall-e
+WALL_E_PORT=3457 node agent.js
+```
+
+## Available Tools
+
+| Tool | Description |
+|---|---|
+| `search_memories` | Full-text search across Slack, email, calendar memories |
+| `calendar_events` | Get upcoming events with attendees, location, notes |
+| `remember_fact` | Store new knowledge in the brain |
+| `run_skill` | Execute any bundled or custom skill |
+| `list_mcp_tools` | Discover tools from Wall-E's MCP connections |
+
+## Example Prompts
+
+Once connected, you can ask Claude Code:
+
+- "What meetings do I have tomorrow?"
+- "What did I discuss with Alice last week?"
+- "Remember that I prefer Tailwind over Bootstrap"
+- "Search my memories for the database migration discussion"
+- "Run the morning briefing skill"
+
+## Adding to Project CLAUDE.md
+
+To give Claude Code automatic context about Wall-E in your projects:
+
+```markdown
+## Wall-E (Personal Digital Twin)
+
+Wall-E is connected as an MCP server. Use it to:
+- Search the owner's memories and knowledge base
+- Check calendar events and meeting schedules
+- Look up past Slack conversations for context
+```

package/template/docs/site/src/content/docs/guides/configuration.md

@@ -0,0 +1,100 @@
+---
+sidebar:
+  order: 2
+title: Configuration
+---
+
+Wall-E is configured through environment variables (`.env` file) and a JSON config file.
+
+## Environment Variables
+
+Copy `.env.example` to `.env` at the project root:
+
+```bash
+cp .env.example .env
+```
+
+### Required
+
+| Variable | Description |
+|---|---|
+| `ANTHROPIC_API_KEY` | Your Anthropic API key. Required for Wall-E chat, think/reflect loops, and agent-mode skills. |
+| `WALLE_OWNER_NAME` | Your full name. Used in system prompts and memory attribution. |
+
+### Data Storage
+
+| Variable | Default | Description |
+|---|---|---|
+| `WALL_E_DATA_DIR` | `~/.walle/data` | Directory for Wall-E's brain database and backups |
+| `CTM_DATA_DIR` | `~/.walle/data` | Directory for CTM's database, images, and backups |
+
+### Slack Integration {#slack}
+
+| Variable | Description |
+|---|---|
+| `SLACK_TOKEN` | Slack user or bot token (starts with `xoxb-` or `xoxp-`) |
+| `SLACK_BOT_TOKEN` | Slack bot token (for DM channel) |
+| `SLACK_OWNER_USER_ID` | Your Slack user ID (e.g., `U0XXXXXXXX`). Used to detect message direction. |
+| `SLACK_OWNER_HANDLE` | Your Slack handle (e.g., `your.name`). Used in search queries. |
+
+### API Gateway
+
+| Variable | Description |
+|---|---|
+| `ANTHROPIC_BASE_URL` | Override API endpoint (e.g., for Portkey gateway) |
+| `ANTHROPIC_CUSTOM_HEADERS_B64` | Base64-encoded JSON headers for the gateway |
+
+### Server
+
+| Variable | Default | Description |
+|---|---|---|
+| `CTM_PORT` | `3456` | CTM HTTP server port |
+| `CTM_HOST` | `127.0.0.1` | CTM bind address |
+| `WALL_E_PORT` | `3457` | Wall-E standalone HTTP port (when running separately) |
+
+## Wall-E Config File
+
+`wall-e/wall-e-config.json` controls the daemon behavior:
+
+```json
+{
+  "owner": {
+    "name": "Your Name",
+    "first_name": "Your",
+    "last_name": "Name",
+    "timezone": "America/Los_Angeles"
+  },
+  "adapters": {
+    "ctm": { "enabled": true },
+    "slack": { "enabled": false }
+  },
+  "intervals": {
+    "ingest": 60000,
+    "think": 120000,
+    "reflect": 3600000,
+    "skills": 300000
+  }
+}
+```
+
+## Calendar Sync {#calendar}
+
+Calendar sync uses macOS EventKit (the same framework as the Calendar app). It reads all calendars synced to your Mac — Google Calendar, iCloud, Outlook, etc.
+
+**Setup:**
+
+1. The first time the calendar skill runs, macOS will prompt for Calendar access
+2. Grant access to your terminal app in **System Settings > Privacy & Security > Calendars**
+3. Events are synced every 30 minutes automatically
+
+No additional configuration needed — it reads whatever calendars are visible in the macOS Calendar app.
+
+## Email Sync
+
+Email sync reads sent messages from macOS Mail using JXA (JavaScript for Automation).
+
+**Setup:**
+
+1. Ensure the macOS Mail app is configured with your email accounts
+2. Grant Accessibility access to your terminal if prompted
+3. Sent emails are synced every 30 minutes automatically

package/template/docs/site/src/content/docs/guides/quickstart.md

@@ -0,0 +1,162 @@
+---
+sidebar:
+  order: 1
+title: Getting Started with Wall-E
+---
+
+Get Wall-E running in under 2 minutes. No manual configuration needed — everything is auto-detected or configured in the browser.
+
+## Prerequisites
+
+- **Node.js** 18+ (recommended: 20+)
+- **macOS** (for Calendar and Mail integration via EventKit/JXA)
+- **Anthropic API key** ([get one here](https://console.anthropic.com/settings/keys))
+
+## Install
+
+### Option 1: npx (Recommended)
+
+```bash
+npx create-walle my-agent
+cd my-agent
+node claude-task-manager/server.js
+```
+
+That's it. Your name and timezone are auto-detected from `git config` and your system. Open **http://localhost:3456** — you'll be guided through the rest.
+
+### Option 2: Clone manually
+
+```bash
+git clone <repo-url> walle
+cd walle
+cd claude-task-manager && npm install && cd ..
+cd wall-e && npm install && cd ..
+node claude-task-manager/server.js
+```
+
+Same result — the server auto-creates `.env` and config files on first run.
+
+## Browser Setup
+
+On first launch, you'll see the setup page at **http://localhost:3456/setup.html**:
+
+### 1. Owner (auto-filled)
+
+Your name is detected from `git config user.name`. Edit it if needed.
+
+### 2. Anthropic API Key
+
+Paste your API key. This powers Wall-E's chat, thinking, and reflection loops. Your key is stored locally in `.env` and never sent anywhere except the Anthropic API.
+
+### 3. Integrations
+
+Connect your data sources — all optional, enable any time:
+
+| Integration | How to connect | What it does |
+|---|---|---|
+| **Slack** | Click "Connect" → OAuth in browser | Syncs messages, searches conversations |
+| **Email** | Automatic on macOS | Reads sent mail via macOS Mail (AppleScript) |
+| **Calendar** | Automatic on macOS | Syncs events via EventKit (Google, iCloud, Outlook) |
+
+Slack uses the same OAuth flow as the Claude Code Slack integration — just click "Connect" and authorize in your browser. No tokens to copy-paste.
+
+### 4. Save & Go
+
+Hit **Save & Continue**, then click **Go to Dashboard →**. You're done.
+
+## What You'll See
+
+### Dashboard (http://localhost:3456)
+
+The main interface has five tabs:
+
+- **Sessions** — Terminal multiplexer for Claude Code. Create and manage multiple sessions.
+- **Prompts** — Rich-text prompt editor with versioning, folders, and one-click send to any session.
+- **Tasks** — Task dashboard with recurring tasks, skill execution, and live logs.
+- **Wall-E** — Chat with your digital twin. Ask about your schedule, search memories, run skills.
+- **Reviews** — Code review with inline diffs.
+
+### Wall-E Chat
+
+Open the **Wall-E** tab and start chatting:
+
+```
+You: What meetings do I have tomorrow?
+You: Summarize my Slack conversations from last week
+You: What does Alice think about the migration plan?
+You: Run the morning briefing skill
+```
+
+Wall-E answers from its brain — your actual Slack messages, calendar events, and emails.
+
+## Background Loops
+
+Once running, Wall-E automatically:
+
+| Loop | Interval | What it does |
+|---|---|---|
+| **Ingest** | 60s | Pulls new data from Claude Code session logs |
+| **Think** | 2 min | Extracts knowledge from recent memories |
+| **Reflect** | 1 hr | Generates daily summaries, resolves contradictions |
+| **Skills** | 5 min | Runs scheduled skills (calendar sync, Slack sync, etc.) |
+| **Tasks** | 30s | Executes due recurring tasks |
+
+Wall-E starts with an empty brain and gets smarter over time as it ingests your data.
+
+## Bundled Skills
+
+These run automatically on a schedule:
+
+| Skill | Schedule | Description |
+|---|---|---|
+| `google-calendar` | every 30 min | Syncs macOS Calendar events via EventKit |
+| `slack-sync` | every 15 min | Incremental Slack message sync |
+| `email-sync` | every 30 min | Syncs sent emails from macOS Mail |
+| `morning-briefing` | daily 7am | AI-generated daily briefing |
+| `memory-search` | on-demand | Full-text search across all memories |
+| `slack-backfill` | manual | Full Slack history (2022–present) |
+| `email-digest` | daily 7am | Email activity summary |
+
+## Using with Claude Code
+
+Wall-E can also run as an MCP server inside Claude Code, giving Claude access to your brain:
+
+```bash
+# In your Claude Code settings, add Wall-E as an MCP server:
+{
+  "mcpServers": {
+    "walle": {
+      "type": "http",
+      "url": "http://localhost:3457/mcp"
+    }
+  }
+}
+```
+
+See [Claude Code Integration](claude-code.md) for the full guide.
+
+## File Layout
+
+```
+walle/
+├── claude-task-manager/     # CTM dashboard (port 3456)
+│   ├── server.js            # HTTP server + WebSocket
+│   ├── public/              # Frontend (HTML/CSS/JS)
+│   └── db.js                # SQLite database
+├── wall-e/                  # Wall-E agent
+│   ├── agent.js             # Daemon entry point
+│   ├── brain.js             # SQLite brain database
+│   ├── chat.js              # Chat engine
+│   ├── skills/              # Bundled + custom skills
+│   └── loops/               # Ingest, think, reflect loops
+├── .env                     # Your config (auto-generated, gitignored)
+├── .env.example             # Config template
+└── bin/setup.js             # First-run auto-setup
+```
+
+## Next Steps
+
+- [Full Configuration Reference](configuration.md) — all environment variables and options
+- [Skill Catalog](../skills/README.md) — bundled skills + how to create custom ones
+- [API Reference](../api/README.md) — HTTP endpoints for CTM and Wall-E
+- [Claude Code Integration](claude-code.md) — use Wall-E as an MCP server

package/template/docs/site/src/content/docs/index.mdx

@@ -0,0 +1,32 @@
+---
+title: Wall-E Documentation
+description: Your personal digital twin — learn how to install, configure, and extend Wall-E.
+template: splash
+hero:
+  title: Wall-E
+  tagline: Your personal digital twin — an AI agent that learns from your Slack, email, and calendar.
+  actions:
+    - text: Get Started
+      link: /docs/guides/quickstart/
+      icon: right-arrow
+    - text: View on GitHub
+      link: https://github.com/ShanniLi/tools
+      variant: minimal
+---
+
+import { Card, CardGrid } from '@astrojs/starlight/components';
+
+<CardGrid>
+  <Card title="Quickstart" icon="rocket">
+    Get Wall-E running in under 2 minutes with `npx create-walle`.
+  </Card>
+  <Card title="Configuration" icon="setting">
+    Environment variables, data directories, and integration settings.
+  </Card>
+  <Card title="Skills" icon="puzzle">
+    7 bundled skills for Slack, email, calendar, and more. Create your own.
+  </Card>
+  <Card title="API Reference" icon="open-book">
+    HTTP endpoints for CTM and Wall-E.
+  </Card>
+</CardGrid>