Knowledge work.
Inside your terminal.

Granit is a local-first workspace for Markdown notes, tasks, planning, and research. One native binary. Your files stay yours.

$ granit open ~/notes

  vault   ~/notes
  notes   local markdown
  mode    offline
  ui      terminal

why granit

Plain Markdown files instead of a proprietary database.
Keyboard-first navigation, editing, search, and commands.
Tasks, calendar, Kanban, daily planning, and backups.
Wikipedia, web, and RSS/Atom sources in searchable Markdown.
Git history, encryption, themes, layouts, and plugins.
Useful offline; network-backed features are optional.

install

Granit requires Go 1.26 or newer. Build the current version from source, or download a prebuilt archive from the releases page.

$ git clone https://github.com/Artaeon/granit.git
$ cd granit
$ make build
$ ./bin/granit init ~/notes
$ ./bin/granit open ~/notes

workflow

# capture without opening the UI
$ granit capture "follow up on the release"

# inspect today's work as JSON
$ granit today --json

# search the vault from scripts
$ granit search "release" ~/notes --json

# bring a public source into the same knowledge graph
$ granit source add https://example.com/feed.xml --limit 10

optional integrations

Git, Ollama, calendar providers, Pandoc, and local connectors extend Granit when enabled. Private or separately installed connectors are opt-in and do not run in the default profile.

read the docs

features complete feature catalog knowledge sources installation keybindings configuration themes plugins architecture security

open source

Granit is released under the MIT License. Issues, focused pull requests, and documentation improvements are welcome.

github.com/Artaeon/granit