Metadata-Version: 2.4
Name: claude-mem-dashboard
Version: 0.2.0
Summary: Local dashboard for exploring your claude-mem memory — sessions, observations, summaries, and prompts.
Project-URL: Homepage, https://github.com/wbingli/claude-mem-dashboard
Project-URL: Issues, https://github.com/wbingli/claude-mem-dashboard/issues
Project-URL: Repository, https://github.com/wbingli/claude-mem-dashboard
Author-email: Wenbing Li <wbinglee@gmail.com>
License: MIT
License-File: LICENSE
Keywords: claude,claude-mem,dashboard,memory
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# claude-mem dashboard

A local dashboard for exploring your [claude-mem](https://github.com/anthropics/claude-code/tree/main/packages/claude-mem) memory — sessions, observations, summaries, and prompts.

![claude-mem dashboard](docs/claude-mem-dashboard.png)

## Run

```bash
uvx claude-mem-dashboard
```

Open <http://127.0.0.1:8765>.

No install step — [`uvx`](https://docs.astral.sh/uv/guides/tools/) fetches the
latest release and runs it in a throwaway environment. If you prefer a
persistent install: `uv tool install claude-mem-dashboard`, then just run
`claude-mem-dashboard`.

Use a different database or port:

```bash
uvx claude-mem-dashboard --db ~/.claude-mem/claude-mem.db --port 9000
```

Environment variables are also supported:

- `CLAUDE_MEM_DB`
- `CLAUDE_MEM_DASHBOARD_HOST`
- `CLAUDE_MEM_DASHBOARD_PORT`

### Lifecycle commands

```bash
uvx claude-mem-dashboard start -d     # run in the background
uvx claude-mem-dashboard status       # show pid + url
uvx claude-mem-dashboard stop         # stop the background process
uvx claude-mem-dashboard restart      # stop + start -d
```

If the port is already taken by another `claude-mem-dashboard` instance, the
default `start` quietly prints the existing URL instead of crashing. Background
runs write a PID file at `~/.claude-mem/dashboard.pid` and append logs to
`~/.claude-mem/dashboard.log`.

### Run from source

```bash
git clone https://github.com/wbingli/claude-mem-dashboard.git
cd claude-mem-dashboard
uv run python -m claude_mem_dashboard
```

## What it shows

- Hero metrics: sessions, prompts, observations, summaries, and discovery tokens with sparklines.
- Interactive activity chart with brush-to-zoom and hover tooltips.
- Observation type and platform source breakdowns.
- Project drill-in with timeline, per-kind tabs, and filtering.
- Record detail modals with body, file lists, and tags.
- Command-palette search (`⌘K`) with keyword matching across all record types.
- Paginated record feed with project, type, and text filters.

## Design

The app is dependency-light by design. The backend is a read-only Python
standard-library HTTP server. The frontend is plain HTML/CSS + JSX compiled
in-browser by Babel (no build step). React and Babel are loaded from CDN.
