supernote

a terminal app that's half daily ritual, half second brain. opens to an affirmation, won't let you close it until you've journaled what you learned, then auto-categorizes it into your knowledge graph and turns any thought into an Excalidraw diagram — all powered by your existing Claude Code subscription.

╭─ supernote ─ 🔥 day 12 ───────────────╮
│                                        │
│  ✨ "you're becoming the person       │
│      you needed when you were         │
│      younger"                         │
│                                        │
│  📚 last entry: Mon May 6 · total 11  │
│                                        │
│  press ↵ to journal · q to bail       │
│                                        │
╰────────────────────────────────────────╯

why

Most note apps are passive. They wait for you. They don't ask what you learned today; they don't make sure you write something before bed; they don't quietly slot your scribbles into a knowledge graph that grows with you. supernote does.

It is opinionated by design:

• a daily lock-screen ritual — affirmation, streak counter, and a textbox you can't close until you've written 30 words.
• AI-categorized in real time — every entry gets slotted into a path like ai/attention/kv-cache or self/relationships. Reuses existing branches; creates new ones only when nothing fits.
• Obsidian-compatible vault — plain markdown with YAML front-matter at ~/.supernote/vault/. Yours, forever. No cloud, no lock-in.
• supernote draw "..." — describe anything in plain English, get a real .excalidraw file that opens in Excalidraw or its desktop app.
• uses your existing Claude Code subscription — no new API key required. Falls back to OpenRouter free models if you don't have Claude.

install

brew install go            # if you don't already have Go
git clone https://github.com/Aankirz/supernote.git
cd supernote
go install .               # installs to $(go env GOPATH)/bin/supernote

Or just run it locally:

go build -o supernote .
./supernote

first run

You need an AI provider. Pick one:

Claude Code (recommended — free with your subscription)

# Already have Claude Code? You're done.
claude auth status         # should print authenticated info
supernote init             # confirms detection

OpenRouter (free models available)

# Get a free key at https://openrouter.ai/keys
export OPENROUTER_API_KEY=sk-or-v1-...
supernote init

usage

supernote                  # the daily ritual
supernote draw "..."       # plain English → Excalidraw diagram
supernote progress         # streak + recent categories
supernote where            # print vault path
supernote init             # detect & confirm AI provider

the ritual

1. splash — affirmation + streak counter
2. journal — typed entry, locked behind a 30-word minimum (configurable via SUPERNOTE_TARGET)
3. categorize — AI proposes a path like rust/lifetimes/elision. You can save, edit the path, or skip
4. done — your journal is on disk, your streak is alive, your knowledge graph just got a new node

the draw

supernote draw "the lifecycle of an HTTP request through a typical Next.js app"
# → ~/.supernote/vault/drawings/2026-05-08-the-lifecycle-of-an-http-r.excalidraw
# → opens in your default app (drag into excalidraw.com if no handler)

env vars

var	default	meaning
SUPERNOTE_PROVIDER	auto	auto, claude, or openrouter
SUPERNOTE_MODEL	(provider default)	override model id (e.g. sonnet, deepseek/deepseek-r1:free)
SUPERNOTE_DRAW_MODEL	same as SUPERNOTE_MODEL	use a different model for draw
SUPERNOTE_HOME	~/.supernote	vault root
SUPERNOTE_TARGET	30	minimum words to unlock save
OPENROUTER_API_KEY	—	required for openrouter provider

vault layout

~/.supernote/
└── vault/
    ├── journal/
    │   └── 2026-05-08.md          # one file per day, plain markdown + YAML
    ├── notes/
    │   └── ai/
    │       └── attention/
    │           └── kv-cache.md    # categorized notes — point Obsidian here
    └── drawings/
        └── 2026-05-08-...excalidraw

why Go + Charm

Single static binary. No Python venv, no Node version drama. The Charm stack (Bubble Tea, Lipgloss, Bubbles) is the canonical aesthetic for terminal UIs in 2026 — soft pastels, rounded borders, gradients, hand-typed feel.

roadmap (post-v0.1)

• AI-generated affirmations after day 7 (woven from your own past entries)
• supernote review — year-in-review with ASCII charts
• human/tech twin tabs — split progress dashboard
• knowledge-graph view — interactive ASCII tree of your concepts
• embeddings + supernote search "..." — semantic recall over the vault
• export → public digital garden site

license

MIT. See LICENSE.

---

made for people who want to think in public, in private, every day.