flint

A terminal user interface for managing tasks stored as Obsidian-compatible markdown notes, built in Go using the Charm ecosystem.

Prerequisites

• Go 1.21+
• An Obsidian vault (or any directory following the expected layout)

Installation

go install github.com/philbalchin/flint@latest

Or build from source:

git clone https://github.com/philbalchin/flint
cd flint
go build -o flint .

Configuration

Config is loaded from (in order):

1. $FLINT_CONFIG env var
2. ~/.config/flint/config.toml

# Required
vault_path   = "/path/to/your/ObsidianVault"
tasks_folder = "Tasks"   # subfolder within the vault containing Inbox/ and Archive/

On first run with no config, Flint prints an error with setup instructions and exits.

Vault Layout

<vault_path>/
└── <tasks_folder>/        # e.g. "Tasks"
    ├── Inbox/
    │   ├── Fix login bug on mobile.md
    │   └── Write Q2 roadmap doc.md
    └── Archive/
        └── Update dependency versions.md

Inbox/ and Archive/ are created automatically if they don't exist.

Task File Format

Files are plain .md files. The filename (without .md) is the task title.

---
status: new          # new | in-progress | blocked | completed
tags:
  - backend
  - auth
created: 2026-03-13
---

Reproduced consistently on iOS Safari. Likely related to the cookie
SameSite attribute change in the last deploy.

Related note: [[Auth Middleware Refactor]]

Keybindings

Key	Action
↑ / k	Move selection up
↓ / j	Move selection down
pgup / pgdn	Scroll preview panel
tab	Toggle focus between list and preview
e	Open note in $EDITOR
alt+e	Open note in Obsidian
c	Create new task
a	Archive selected task (completed tasks only)
/	Filter list
q / ctrl+c	Quit

CLI Flags

Flag	Description
--create	Launch directly into the Create Task form. Exits on submit (0) or cancel (non-zero).

Example usage from a shell alias or script:

flint --create