# Hermes OS

Mobile-first dashboard for [Hermes Agent](https://github.com/NousResearch/hermes-agent). View memory, browse sessions, manage skills, edit your persona — all from your phone.

## Quick Start

```bash
npm ci
HERMES_BACKEND_URL=http://127.0.0.1:8643 npx next build
HERMES_BACKEND_URL=http://127.0.0.1:8643 npx next start -p 3100 -H 0.0.0.0
```

Requires the Hermes WebAPI running (FastAPI, typically on port 8643).

## Modules

- **Pulse** — status, recent sessions, memory usage, quick links
- **Memory** — view/edit agent + user memory entries
- **History** — session list, platform filter, full-text search, session replay
- **Skills** — browse all skills by category, view SKILL.md content
- **Cron** — view scheduled jobs, trigger manually
- **Soul** — edit SOUL.md persona file

## Environment

| Variable | Default | Description |
|---|---|---|
| `HERMES_BACKEND_URL` | `http://127.0.0.1:8643` | Hermes WebAPI (FastAPI) |
| `HERMES_GATEWAY_URL` | `http://127.0.0.1:8642` | Hermes Gateway (aiohttp) |
| `HERMES_SOUL_PATH` | `~/.hermes/SOUL.md` | Path to persona file |

## Stack

Next.js 15, TypeScript, Tailwind CSS, TanStack Query, Lucide icons. PWA-ready.