Granit — Terminal Knowledge Manager

Features

Everything you need.
Nothing you don't.

Notes, tasks, goals, habits, calendar, AI, and daily planning. One binary. One keyboard. Zero subscriptions.

✨

23 AI Bots

Auto-tagger, auto-linker, summarizer, flashcards, writing coach, deep dive research agent, plan my day, and more. All optimized for small local models.

Ollama / OpenAI / Claude

⌨️

Full Vim Mode

Modal editing with text objects, marks, macros, registers, dot repeat, search highlighting, and ex commands. Everything you expect from Vim.

168 commands

🎨

40 Themes

Catppuccin, Tokyo Night, Gruvbox, Nord, Dracula, and 35 more. Plus accessibility themes and a live theme editor with 16 color roles.

+ custom themes

✅

Task Manager

7 views including Kanban and Eisenhower Matrix. Subtasks, dependencies, snooze, templates, recurring auto-creation, natural language dates, and 10-deep undo.

Ctrl+K

🎯

Goals & Projects

Track long-term goals with milestones, due dates, recurring reviews, progress sparklines, burndown charts, and AI coaching with velocity tracking.

AI goal coach

📅

Calendar

6 views: month, week, 3-day, day, agenda, year. Full-width weekly grid with time-blocking, event wizard, ICS sync, and goal badges.

Ctrl+L

📂

Smart Explorer

Hierarchical file tree with persistent collapse state, fuzzy search, Vim-style navigation, and daily/weekly note markers. z to collapse all, Z to expand all.

session persistent

🔀

Git & Nextcloud Sync

Built-in git overlay with status, log, diff, commit, push, pull, and author config. Nextcloud WebDAV bidirectional sync. One-command CLI sync.

granit sync

🔗

Obsidian Compatible

Full support for [[wikilinks]], YAML frontmatter, backlinks, note graph, canvas, and dataview queries. Point Granit at your existing vault.

zero migration

🔍

Universal Search

Fuzzy search across notes, tasks, goals, and habits. Semantic search with AI embeddings. Content search and regex. Ranked results with instant navigation.

Ctrl+/

🧩

Plugin System

16 core plugins included. Extend Granit with Lua scripts. Hook into save, open, create, and delete events. Build your own workflows.

Lua API

📐

17 Layouts

Default, writer, reading, dashboard, zen, cockpit, research, calendar, cornell, focus, preview, presenter, kanban, widescreen, and more. Switch instantly with Alt+L.

Alt+L

☕

Morning Routine

Start each day with scripture, set a goal, select tasks, toggle habits, and write your thoughts. Everything saved to your daily note automatically.

Alt+M

🔥

Habits & Streaks

Track daily and weekly habits with streak counters, completion history, and visual charts. Integrated with morning routine and dashboard.

Alt+H

🔒

Encryption

AES-256-GCM encryption for sensitive notes. Encrypt individual notes and sync safely across devices without compromising privacy.

per-note

Showcase

Built for how you actually work.

A deeper look at what makes Granit different from everything else.

A real editor, in your terminal.

Not a toy. Full syntax highlighting for 200+ languages, multi-cursor editing, wikilink autocomplete, Ghost Writer AI suggestions, and a rendered reading mode with Mermaid diagrams and callout blocks.

Multi-cursor editing with Ctrl+D and Ctrl+Shift+Up/Down
Ghost Writer: inline AI suggestions, Tab to accept
Full Vim mode with macros, marks, and dot repeat
18 built-in snippets, smart bracket auto-close
Find and replace with regex, in-file and global

Tasks, goals, and plans. Unified.

Your tasks live inside your notes. Granit finds them all, gives you 7 views to organize them, and connects them to goals with milestones, reviews, and AI coaching. No separate app needed.

7 views: Today, Upcoming, All, Done, Calendar, Kanban, Eisenhower
Subtasks, dependencies, snooze, pin, and templates
Natural language dates: @next week, @friday
Goal manager with milestones and progress sparklines
AI-powered task triage and priority suggestions

A calendar that lives in your terminal.

Six views from year overview to hourly day planner. Time-block your tasks, import ICS calendars, track goal milestones, and create events with a guided wizard -- all without leaving the keyboard.

Month, week, 3-day, day, agenda, and year views
Time-blocking: assign tasks to hourly slots
ICS calendar sync with RRULE recurrence support
Event wizard with title, time, duration, color, and recurrence
Goal badges and daily focus in week headers

Who is it for?

Built for people who think
in plain text.

Whether you're writing code, writing prose, or writing your thesis -- Granit adapts to how you work.

💻

Developers & Engineers

You live in the terminal. Your IDE, git, and builds are there. Granit fits right in -- tmux split, SSH session, or standalone. Capture ideas with granit note without leaving your flow. Git sync keeps everything versioned.

🎓

Researchers & Students

Build a knowledge graph with [[wikilinks]]. Generate flashcards from your notes with AI. Semantic search finds connections you didn't know existed. Track your reading list with progress bars.

✍️

Writers & Creators

Focus Mode strips away everything except your words. Ghost Writer offers inline AI suggestions. 17 layouts for drafting, editing, and outlining. Export to HTML, PDF, or publish to Medium and GitHub Pages.

🏆

Productivity Enthusiasts

Morning routine, evening review, habit streaks, Pomodoro timer, Eisenhower Matrix, Kanban boards, goal milestones, clock-in/out time tracking -- all in one place. No subscriptions.

Daily Workflow

A day with Granit.

Granit isn't just a note app. It's a system for your entire day.

6:30 AM — Morning Routine

Plan your day with intention

Press Alt+M. Read a scripture verse. Set your daily goal. Select tasks from your vault. Toggle today's habits. Write a quick thought. Everything saves to your daily note.

9:00 AM — Deep Work

Capture without context-switching

An idea hits mid-flow. Without leaving your terminal: granit note "Consider event sourcing for audit trail". Done. Back to code. The Deep Dive Research Agent (Alt+R) runs in the background.

12:00 PM — Quick Capture

Tasks from anywhere

Lunch meeting produced action items. Fire off granit todo "Draft migration guide" --due friday from any terminal. Press Alt+J for quick timestamped jots throughout the day.

3:00 PM — Calendar & Focus

Time-block and execute

Check your calendar with Ctrl+L. Time-block the afternoon. Start a focus session with Pomodoro timer. Ctrl+Z for distraction-free zen mode.

5:30 PM — Review & Sync

Reflect and prepare for tomorrow

Press Alt+E for the evening review. See what you accomplished, audit overdue tasks, plan tomorrow. Then granit sync commits and pushes everything.

Compare

Granit vs the alternatives.

An honest comparison. We think the numbers speak for themselves.

Feature	Granit	Obsidian	Notion
Price	Free forever (MIT)	$50/yr + $8/mo sync	$8-10/mo
Open source	✓ MIT	✗	✗
Terminal native	✓	Electron	Web
Startup time	~12ms	~2s	~3s
Memory usage	~30 MB	~500 MB	~500 MB
Binary size	~32 MB	~300 MB	N/A
Vim mode	Full (macros, objects, marks)	Plugin	✗
AI integration	23 bots, local or cloud	$14/mo add-on	Cloud only
Task manager	7 views + Eisenhower + Kanban	Plugin	Built-in
Calendar	6 views + time-blocking	Plugin	Built-in
Goal tracking	Built-in + AI coaching	✗	✗
Habit tracking	Built-in with streaks	✗	Template
Daily routines	Morning + Evening + Jot	✗	✗
Themes	40 built-in + editor	Community	Limited
Layouts	17 built-in	1	1
Works offline	Always	Paid sync	✗
Data format	Plain Markdown	Plain Markdown	Proprietary

Philosophy

What we believe.

The principles behind every design decision in Granit.

Your data is yours

Plain Markdown files in a folder. No proprietary database, no cloud lock-in, no account required. Move your notes to any app, any time. Git gives you version history for free.

Speed is a feature

Granit loads in 12ms because your tools should never make you wait. No Electron, no browser engine, no JavaScript bundle. Just native Go compiled to a single binary.

AI should be private

Every AI feature works with local models via Ollama. Your notes never leave your machine unless you choose to use a cloud provider. A 0.5B model on CPU is enough for most features.

One tool, not ten

Notes, tasks, goals, habits, calendar, journal, and AI in one place. No context-switching between Obsidian, Todoist, Notion, and Google Calendar. Everything is connected.

Keyboard-first, always

Every feature is reachable without a mouse. 168 commands in the palette. Full Vim mode. 17 layouts. The terminal is your most powerful interface -- we build for it.

Free means free

MIT license. No "Pro" tier, no per-seat pricing, no feature gates, no telemetry. The full feature set, forever. We believe the best tools should be accessible to everyone.

Get Started

Install in seconds.

One command to get started. Works on Linux and macOS. Your existing Obsidian vault works out of the box.

terminal
# Install with Go
go install github.com/artaeon/granit/cmd/granit@latest

# Create your first vault
granit init my-vault

# Or open an existing Obsidian vault
granit ~/Documents/ObsidianVault

# Quick capture from anywhere
granit note "My first note from the terminal"
granit todo "Try all 23 AI bots" --priority high

Requirements: Go 1.24+, Git, Linux or macOS
Optional: Ollama (local AI), aspell (spell check), pandoc (PDF export), Claude Code (research agent)

FAQ

Common questions.

Everything you need to know before getting started.

Yes. Point Granit at your Obsidian vault directory and everything works: [[wikilinks]], backlinks, YAML frontmatter, tags, daily notes, and canvas files. You don't need to migrate, convert, or change anything. Both apps can use the same vault simultaneously.

No. Granit works fully offline. AI features run locally via Ollama. Cloud providers (OpenAI, Claude) are optional. Sync only connects when you explicitly run it.

Granit gives you a fully integrated system out of the box -- no plugin hunting, no configuration, no breaking updates. Tasks, calendar, goals, habits, AI, and daily routines all work together. Think of it as Neovim's editing DNA combined with Notion's feature set, in a single binary.

Any Ollama-compatible model works. We recommend qwen2.5:0.5b for fast, lightweight AI on CPU. Larger models (llama3.1:8b, mistral:7b) improve writing and planning quality. OpenAI models (GPT-4o-mini) also work. The Deep Dive Research Agent uses Claude Code.

Three options: (1) granit sync uses git — pull, commit, push in one command. (2) Nextcloud WebDAV sync is built-in. (3) Any folder sync (Dropbox, Syncthing, rsync) works since notes are plain files.

Not yet, but it's on the roadmap. In the meantime, you can access your notes on mobile through any Markdown editor that supports your sync method (git, Nextcloud, Dropbox). Obsidian Mobile works perfectly since Granit vaults are fully Obsidian compatible.

Any terminal with 256-color support. Recommended: Alacritty, Kitty, Ghostty, WezTerm, or iTerm2. Works well in tmux and screen. Nerd Font icons are supported but optional.

Open Source

Built in the open.

Granit is MIT-licensed. Every line of code is public. Contributions welcome.

📜

MIT License

Use Granit for anything -- personal, commercial, educational. Fork it. Modify it. Distribute it. No restrictions.

🤝

Contributions Welcome

Add themes, AI bots, plugins, or documentation. Every PR makes Granit better for everyone. New contributors start with good-first-issue tags.

🌍

No Vendor Lock-in

Plain Markdown files. Standard git sync. If you ever leave, your data comes with you. No export needed. No proprietary format. No account to delete.

Your second brain,in your terminal.

Everything you need.Nothing you don't.