Your computer remembers your work.
A local-first AI memory layer for developers — watches your browser and terminal,
understands what you were actually trying to accomplish, and hands it back to you the moment you return.

Getting Started · Features · Tech Stack · Structure

---

Getting Started

npm run dev

Starts two things:

• FlowState at http://localhost:3000
• Supermemory local server at http://localhost:6767 (auto-installed on first run)

FlowState picks up Ollama automatically if it's running. Otherwise it falls back to local embeddings.

Click "Load demo data" in the sidebar to see it in action with sample memories.

Features

Timeline

Every memory surfaces here — commands you ran, errors you fixed, research you did. Filter by category, search by keyword.

Knowledge Graph

An interactive visual map of your work. Memory nodes connect to the technologies and projects they belong to. Drag, zoom, explore. Powered by litegraph.js.

Insights

The engine scans all your memories and surfaces patterns you might miss. "You've debugged JWT issues 4 times this week." "Docker keeps showing up in your problem sessions."

Repeat Detection

Paste in what you're about to do. FlowState checks if you've done it before and tells you what happened last time.

Ask FlowState

Chat with your memory. Ask about projects, decisions, bugs, or anything you've worked on. Every answer is grounded in your work history.

All of this runs locally. No cloud, no telemetry, no account required.

Tech Stack

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · Framer Motion · litegraph.js · Lucide Icons · Supermemory SDK

Project Structure

src/
├── app/                        — Pages and layouts
│   ├── app/                    — Dashboard (Home, Ask, Timeline, Graph, Insights, Detect)
│   ├── api/                    — API routes (auth, chat, collectors)
│   └── page.tsx                — Landing page
├── components/
│   ├── sections/               — Landing page sections
│   ├── layout/                 — Sidebar, offline indicator
│   ├── flowstate/              — Home dashboard + WelcomeBack
│   ├── ask-flowstate/          — Chat UI (messages, input, sidebar, evidence)
│   ├── timeline/               — Timeline panel
│   ├── graph/                  — Interactive memory graph
│   ├── reflection/             — Insight patterns
│   ├── repaint/                — Repeat detection
│   ├── auth/                   — Auth wrapper + user profile
│   ├── shared/                 — Reusable primitives
│   └── ui/                     — Generic UI components
├── lib/                        — Data stores, client SDKs, engines
├── stores/                     — React contexts (memory, chat, auth)
└── types/                      — TypeScript definitions

Environment

Variable	Description
GROQ_API_KEY	Optional — enables LLM-powered chat responses
GOOGLE_CLIENT_ID	Optional — enables Google OAuth sign-in
GOOGLE_CLIENT_SECRET	Optional — OAuth secret (rotate if exposed)

Supermemory local falls back to local embeddings if Ollama isn't available. All data lives in .supermemory/ at the project root — delete it to start fresh.

---

_{Built for the Supermemory Local Hackathon}