AI-native bullet journal for ADHD brains.

Sequential logging · Jira triage · AI meeting prep · Voice capture Local-first · Privacy-first · Zero context switching

---

Gutter is a personal productivity system built around the Bullet Journal method — wired up with the stuff that actually matters: AI that runs locally, Jira integration so you don't lose your flow, voice transcription, natural language commands, and meeting prep that does the research for you.

It's not a note-taking app. It's not a task manager. It's the place you dump everything — tasks, thoughts, appointments, blockers — and let the system help you make sense of it.

Designed specifically for the way ADHD brains actually work. Low friction capture, external scaffolding, zero context switching.

Because context switching destroys productivity.

You're working on GDEV-247 when Slack pings. Meeting in 5 minutes. You open Jira to find the ticket, open your notes to find the context from last week, check your calendar to see who's coming, scan the thread for background... 10 minutes later you're late and half-prepared.

Gutter fixes this:

• Sequential logging — One place for everything. Task, note, blocker, whatever. It all goes in the log with a signifier.
• AI meeting prep — One click. Ollama pulls your Jira tickets, Slack context, and local notes, then generates prep notes.
• Natural language commands — meeting at 3pm with Ryan creates the appointment. done with GDEV-123 marks it complete. No forms, no clicking.
• Voice capture — Driving? Walking? Hit the mic button, dump your thought, keep moving.
• Calendar integration — Apple Calendar events show up in the monthly grid and day view. No switching apps.
• Jira triage — See your backlog, create issues, mark done — all without leaving the log.
• Local-first — Your data stays on your machine. Ollama runs locally. No cloud APIs harvesting your notes.

Built for ADHD:

• Fast capture — zero friction between thought and log entry
• External structure — the system remembers what you'd forget
• Visual signifiers — color-coded tasks, appointments, notes at a glance
• Migration ritual — monthly review forces closure, not guilt
• No overwhelm — one day at a time, one task at a time

For engineers who think in tickets:

• Jira integration that doesn't suck
• Natural language commands that feel like CLI
• Dark themes that don't burn your retinas at 2am
• SQLite backend you can grep if you want
• MIT license — fork it, break it, make it yours

git clone <repo-url>
cd gutter
bun install
cp .env.example .env
bun run dev
# → http://localhost:3000

The full BUJO system as a web app.

• Daily Log — Sequential entries, signifier-tagged, timestamped
• Monthly Calendar — Color-coded grid synced from Apple Calendar
• Day Detail — Events, entries, and meeting prep in one view
• Future Log — Plan entries for upcoming months without cluttering today
• Collections — Topic-specific pages: Books, Goals, Recipes, whatever
• Migration — End-of-month review. Mark done, carry forward, or drop

No cloud APIs. No data leaving your machine.

• Natural Language Commands — Type like a human. The system figures it out.
• Meeting Prep — One click. Ollama searches your Jira tickets, Slack channels, and local notes, then generates formatted prep notes with context and talking points.
• Transcript Upload — Paste a meeting transcript, get a summary and action items back
• AI Triage — Surface what matters in your Jira backlog without reading 47 tickets

# Get Ollama running with a tool-calling model
ollama pull qwen3

• Multi-project support — JIRA_PROJECTS=GDEV,ISE
• Pull open tickets into your daily context
• Create issues directly from journal entries
• Update issue status without leaving the app
• 5-minute in-memory cache so you're not hammering the API

• Hit the mic, speak your entry
• Local transcription via whisper.cpp — no Whisper API, no cloud
• Voice input runs through the same NL command interpreter

brew install whisper-cpp ffmpeg
mkdir -p ~/.cache/whisper
curl -L https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin \
  -o ~/.cache/whisper/ggml-base.en.bin

• Reads from Apple Calendar (any calendars you specify)
• Color-coded monthly grid
• Natural language commands create real Apple Calendar events
• Day view shows events alongside journal entries

npm install -g @joargp/accli
npx @joargp/accli calendars list

• OmniBar — Full-text search across all entries. Always accessible.
• Subtasks — "Buy groceries: milk, eggs, bread" creates parent + children
• PWA — Installable, works offline
• Auth — Single-user, password-protected, HTTP-only cookie, 30-day session
• Themes — Cyberpink · Tokyo Night · Rose Pine
• Two DBs — gutter.db for app data, gutter-journal.db for journal (easy to back up separately)

cp .env.example .env

Next.js 16 + React 19   →  framework
Tailwind CSS v4          →  styling
shadcn/ui                →  components
SQLite + better-sqlite3  →  storage (two DBs)
Redux Toolkit + RTK Query →  state
Ollama                   →  local LLM (meeting prep, NL commands)
whisper.cpp              →  local STT (voice capture)
Apple Calendar / accli   →  calendar sync
bun                      →  runtime

gutter/
├── app/
│   ├── page.tsx              # daily log
│   ├── month/page.tsx        # monthly calendar
│   ├── day/[date]/page.tsx   # day detail
│   ├── future/page.tsx       # future log
│   ├── collections/          # collections
│   ├── migrate/page.tsx      # migration review
│   └── api/                  # all api routes
├── components/
│   ├── journal/              # EntryInput, EntryList, OmniBar, VoiceButton, etc.
│   ├── meeting/              # MeetingDrawer
│   └── ui/                   # shadcn components
├── lib/
│   ├── db.ts                 # main db (gutter.db)
│   ├── journal-db.ts         # journal db (gutter-journal.db)
│   ├── jira.ts               # jira integration + cache
│   ├── ollama-prep.ts        # meeting prep with tool calling
│   ├── calendar.ts           # calendar event creation
│   └── env.ts                # env validation
└── store/api/                # RTK Query slices

[ ] = planned   [~] = in progress   [x] = done

bun run dev       # dev server
bun run build     # production build
bun run start     # production server
bun run test      # run tests

╔══════════════════════════╗
║  local-first. always.   ║
╚══════════════════════════╝