██████╗ ██████╗ █████╗ ███╗ ██╗██╗████████╗ ██╔════╝ ██╔══██╗██╔══██╗████╗ ██║██║╚══██╔══╝ ██║ ███╗██████╔╝███████║██╔██╗ ██║██║ ██║ ██║ ██║██╔══██╗██╔══██║██║╚██╗██║██║ ██║ ╚██████╔╝██║ ██║██║ ██║██║ ╚████║██║ ██║ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═══╝╚═╝ ╚═╝

A blazing-fast, AI-powered terminal knowledge manager

Fully Obsidian compatible. No Electron. No browser. No subscriptions. Just your terminal.

Get Started View on GitHub

Go 1.23+ MIT License Linux & macOS Active Development

// Features

Everything you need for knowledge management, built into your terminal.

✨

AI-Powered

20+ AI features with Ollama, OpenAI, and Claude Code support. Auto-tagging, summarization, link suggestions, and local offline fallback.

⌨️

Vim Mode

Full modal editing with Normal, Insert, Visual, and Command modes. Dot repeat, macros, and everything you expect from Vim.

🎨

35 Themes

29 dark and 6 light themes including Catppuccin, Tokyo Night, Gruvbox, Nord, and more. Plus a custom theme editor.

✅

Task Manager

Kanban boards, task priorities, daily planner, and AI smart scheduler. Track your work right alongside your notes.

🔀

Git Integration

Built-in status, log, and diff views. Commit, push, and pull without leaving the TUI. Optional auto-sync on save.

🔗

Obsidian Compatible

Full support for [[wikilinks]], YAML frontmatter, and the same folder structure. Use your existing Obsidian vault as-is.

📐

8 Layouts

Default, Writer, Minimal, Reading, Dashboard, Zen, Taskboard, and Research modes. Adapt the UI to your current workflow.

🧩

Plugin System

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

🔒

Encryption

AES-256-GCM encryption for sensitive notes. Secure your vault for safe syncing across devices without compromising privacy.

// Feature Showcase

A deeper look at what sets Granit apart.

# Editor in Action

A fast, syntax-highlighted Markdown editor with multi-cursor support, wikilink autocomplete, and heading folding -- all in your terminal.

Syntax-highlighted code blocks (Go, Python, JS, Rust, Shell)
Multi-cursor editing with Ctrl+D and column cursors
Ghost Writer: inline AI writing suggestions (Tab to accept)
18 built-in snippets for dates, todos, tables, and more
Rendered view mode with Mermaid diagrams and callouts

# Task Manager & Kanban

Manage your tasks, projects, and priorities without leaving the terminal. A full Kanban board built right into your knowledge base.

6 views: Today, Upcoming, All, Done, Calendar, Kanban
5 priority levels with color-coded indicators
Daily planner with time-blocked schedule view
AI smart scheduler that auto-assigns tasks to time slots
Parse tasks directly from your Markdown notes

# AI-Powered Features

9 specialized AI bots that understand your notes and help you think, write, and organize more effectively.

Auto-Tagger: intelligent tag suggestions from note content
Link Suggester: discovers connections between your notes
Summarizer, Question Bot, and Writing Assistant
Works with Ollama (local), OpenAI, or a built-in offline fallback
Deep Dive Research agent via Claude Code integration

# 35 Themes

From Catppuccin Mocha to Synthwave 84, find a color palette that matches your aesthetic and environment.

29 dark themes and 6 light themes included
Catppuccin, Tokyo Night, Gruvbox, Nord, Dracula, and more
Custom theme editor: create your own color palette
Hot-swap themes instantly from the settings overlay
Every UI element respects the active theme

// Granit vs Obsidian

A detailed, honest comparison. See exactly what you get -- and what you save.

Feature	Granit	Obsidian
Price	Free forever	$50/yr commercial + $8/mo sync + $14/mo AI
Terminal Native	✓	✗
Vim Mode	Full with macros	Plugin
AI Integration	Built-in: Ollama / OpenAI / Claude	$14/mo add-on
Themes	35 built-in + editor	Community
Speed	Instant startup	Electron
Privacy	100% local	Cloud optional
Open Source	✓	✗
Task Manager	Built-in, 6 views	Plugin
Daily Planner	Built-in with AI scheduler	✗
Language Learning	Built-in	✗
Habit Tracker	Built-in	✗
Research Agent	Claude Code integration	✗
Encryption	AES-256-GCM	No built-in

// Keyboard First

Everything is one shortcut away. No mouse required.

Command Palette

Ctrl+X

Quick Switcher

Ctrl+J

New Note

Ctrl+N

Find & Replace

Ctrl+F

AI Bots

Ctrl+R

Task Manager

Ctrl+K

Focus / Zen Mode

Ctrl+Z

Calendar

Ctrl+L

Settings

Ctrl+,

Note Graph

Ctrl+G

Tag Browser

Ctrl+T

Bookmarks

Ctrl+B

// Theme Variety

35 built-in themes. Instantly switch from settings or create your own with the theme editor.

Catppuccin Mocha

Warm, pastel dark (default)

Tokyo Night

Inspired by Tokyo at night

Gruvbox Dark

Retro, earthy warm tones

Nord

Arctic, cool blue palette

Dracula

Classic dark with vivid accents

Rose Pine

Muted, elegant dark

// Installation

Up and running in under a minute. Pick your preferred method.

Go Install (Recommended)

bash

$ go install github.com/artaeon/granit/cmd/granit@latest

Arch Linux (AUR)

bash

# Stable release
$ yay -S granit

# Or latest git version
$ yay -S granit-git

Build from Source

bash

$ git clone https://github.com/artaeon/granit.git
$ cd granit
$ go build -o granit ./cmd/granit
$ sudo mv granit /usr/local/bin/

Quick Start

bash

# Open a vault directory
$ granit open ~/my-vault

# Or launch the vault selector
$ granit

# Try the built-in demo vault
$ granit demo-vault

A blazing-fast, AI-powered terminal knowledge manager

// Features

AI-Powered

Vim Mode

35 Themes

Task Manager

Git Integration

Obsidian Compatible

8 Layouts

Plugin System

Encryption

// Feature Showcase

# Editor in Action

# Task Manager & Kanban

# AI-Powered Features

# 35 Themes

// Granit vs Obsidian

// Keyboard First

// See It in Action

// Theme Variety

// By the Numbers

// Installation

Go Install (Recommended)

Arch Linux (AUR)

Build from Source

Quick Start

// Documentation

Features

Installation

AI Guide

Keybindings

Architecture

Configuration

Plugins

Themes