---
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
