Terminal UI for Gutter — keyboard-driven bullet journal with neon cyberpunk aesthetics.
Built with @opentui/react.
You need a running Gutter backend instance. See the Gutter repository for setup instructions.
cd /path/to/gutter-tui
bun install
bun startOn first launch you'll be prompted to log in directly in the terminal — just type your Gutter password and hit enter. The session token is saved to your OS keychain (macOS) or encrypted file (other platforms), so subsequent runs are automatic.
Remote Gutter instance:
GUTTER_API=http://your-server:3000 bun start| Env var | Default | Description |
|---|---|---|
GUTTER_API |
http://localhost:3000 |
Gutter server URL |
GUTTER_SESSION |
(empty) | Override session token (skips login prompt) |
| Key | Action |
|---|---|
d |
Daily view |
m |
Monthly view |
c |
Collections |
f |
Future log |
n |
New entry |
↑↓ |
Navigate entries |
enter |
Select / expand |
q / ctrl+c |
Quit |
gutter-tui/
├── src/
│ ├── index.tsx # Entry point, router
│ ├── api.ts # Gutter API client
│ ├── secure-storage.ts # OS keychain / encrypted token storage
│ ├── types.ts # Shared types
│ ├── views/
│ │ ├── LoginView.tsx
│ │ ├── DailyView.tsx
│ │ ├── MonthlyView.tsx
│ │ ├── DayDetailView.tsx
│ │ ├── CollectionsView.tsx
│ │ └── FutureLogView.tsx
│ ├── components/
│ └── hooks/
└── package.json
- @opentui/react — React reconciler for terminal UIs
- @opentui/core — Native Zig renderer with yoga-layout