Folio

A markdown vault as memory. A local AI agent as your strategy partner.

Part of Aion Lumen.

---

A vault as memory.
A campaign as structure.
A hearth at the center.

Why Folio exists

Cloud AI forgets you at the end of every session. You start over. Every time. Folio is the generator that keeps the heat on: a local markdown vault holds your full context, a locally-running AI agent reads it directly, and nothing leaves your machine. Markdown as source of truth — no lock-in, no subscription. The full story is at aion-lumen.ch/folio.

Status

Status: v0.1.0 public preview
License: AGPL-3.0
Platforms: Linux / macOS / WSL2

Stack

• SvelteKit 2 + Svelte 5 (Runes), Tailwind CSS 4
• Drizzle ORM + PostgreSQL (optional, for session persistence)
• Local LLMs via Hermes Agent (Nous Research)
• Cytoscape.js for graph visualisations

Quick Start

Prerequisites: Node.js 20+, Hermes Agent installed and running.

git clone https://github.com/aion-lumen/folio.git
cd folio
npm install
npm run build
npm run preview

Open http://localhost:4173 and follow the Setup Wizard. On first launch you can connect an existing vault, start from a demo vault, or create one from scratch.

Environment — create .env in the project root:

VAULT_PATH=/path/to/your/vault
HERMES_API_URL=http://localhost:8642
HERMES_API_KEY=your-key-here

For vault layout and mail integration, see docs/VAULT.md and docs/MAIL.md.

What works today

• Strategic view — campaign banner, all five acts, active chapter
• Tactical view — kanban with drag-and-drop, gantt, objective selection
• Objective detail panel — status, deadline, progress note, history
• Hermes chat — agent reads and edits vault files via tool calls
• Vault format — plain markdown + YAML frontmatter, git-friendly
• Setup wizard, demo vault, model switcher

What's coming

• v0.2 — Voice input (STT), interview-style setup wizard, mobile PWA, approval UI for risky tool calls
• v0.3 — Frostpunk view: generator metaphor, resource decay, harder visual atmosphere
• v1.0 — Multi-user, NAS deployment, public vault templates

See docs/ROADMAP.md for the full roadmap.

Contributing

Built by one person. Slow on purpose. Issues and pull requests welcome.

This is a solo project — contemplative pace, not startup velocity. If something is broken or missing, open an issue.

Acknowledgements

• Andrej Karpathy for thinking out loud about local knowledge bases
• Nous Research for Hermes Agent
• nesquena for Hermes Web UI
• 11 bit studios for Frostpunk 2 (mental model)

License

AGPL-3.0 — see LICENSE.

Design assets (Aion Lumen mark, color system) are CC BY 4.0.

---

Folio provides the engine. The course is yours.

— afm.