# Claude Chat — local dashboard

A small website that runs on your own computer and lets you chat with **Claude Code**
through a browser instead of the terminal. Whatever you ask runs real Claude Code on
**your existing Claude login** (no API key), with full tools — and everything stays
**inside this folder**.

See `ARCHITECTURE.md` for the full design.

## Run it

```sh
npm start
```

Then open **http://localhost:8787** in your browser.

(That's it — no install step. It uses only Node's built-in modules. Requires Node.js and
the `claude` CLI, both already on your machine.)

To use a different port:

```sh
# PowerShell
$env:PORT=9000; npm start
```

## What you get

- **Chat** with streaming replies and live "🔧 reading / writing…" activity.
- **Conversations** — start, switch, rename (double-click the title), delete. Each one
  keeps its full memory.
- **Artifacts panel** — every file Claude writes appears on the right; click to preview,
  or download.

## Where things live (all inside this folder)

| Folder | What |
| --- | --- |
| `server/` | the local web server (Node.js) |
| `public/` | the dashboard you see in the browser |
| `workspace/` | Claude's sandbox — every report/file it makes lands here |
| `data/` | your saved conversations (`conversations.json`) |

## Safety posture

Claude runs **sealed to this folder**:

- File reads/writes happen only inside `workspace/`.
- The **shell is disabled** (no Bash/PowerShell) — nothing can reach the rest of your PC.
- External integrations (e.g. Google Drive MCP) are switched off.

To loosen this later (e.g. let Claude run code), edit the tool lists near the top of
`server/claude-runner.js`.
