8000 GitHub - moogsG/gutter-tui: A terminal UI for gutter — ADHD-friendly Jira triage, AI summaries, and bullet journal capture without leaving the terminal. · GitHub
[go: up one dir, main page]

Skip to content

About

A terminal UI for gutter — ADHD-friendly Jira triage, AI summaries, and bullet journal capture without leaving the terminal.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

gutter-tui

Terminal UI for Gutter — keyboard-driven bullet journal with neon cyberpunk aesthetics.

Built with @opentui/react.

Prerequisites

You need a running Gutter backend instance. See the Gutter repository for setup instructions.


Setup

cd /path/to/gutter-tui
bun install
bun start

On 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

Config

Env var Default Description
GUTTER_API http://localhost:3000 Gutter server URL
GUTTER_SESSION (empty) Override session token (skips login prompt)

Navigation

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

Project structure

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

Stack

  • @opentui/react — React reconciler for terminal UIs
  • @opentui/core — Native Zig renderer with yoga-layout

About

A terminal UI for gutter — ADHD-friendly Jira triage, AI summaries, and bullet journal capture without leaving the terminal.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0