A powerful, keyboard-driven TUI for managing your markdown notes. Built for developers who live in the terminal.
┌─────────────────────────────────────┐ │ 📁 Notes │ │ ├── 📁 work │ │ │ ├── 📄 project-alpha.md │ │ │ └── 📄 meeting-2025-10-27.md │ │ ├── 📁 personal │ │ │ ├── 📄 daily-journal.md │ │ │ └── 📄 ideas.md │ │ └── 📁 learning │ │ └── 📄 python-tips.md │ └─────────────────────────────────────┘
Everything you need to manage your notes efficiently from the terminal
Navigate your notes with an intuitive tree view. Keyboard-driven navigation for maximum efficiency.
See your markdown rendered beautifully with syntax highlighting and rich formatting.
Create notes from 6 built-in templates: journals, meetings, projects, budgets, and more.
Minimal resource usage. Instant startup. Works perfectly over SSH and in remote environments.
Search across all your notes quickly. Find what you need when you need it.
Every action is accessible via keyboard shortcuts. Mouse optional.
Connect your notes with [[wiki-style]] links. Build your personal knowledge base.
Organize notes with tags, categories, and custom metadata.
Beautiful code highlighting powered by Pygments for all major languages.
Get started in seconds with pip or your favorite package manager
# Clone the repository
git clone https://github.com/sirbrasscat/notes-tui.git
cd notes-tui
# Create virtual environment
python -m venv .venv
# Activate (Windows PowerShell)
.\.venv\Scripts\Activate.ps1
# Activate (macOS/Linux)
source .venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Run the app
python -m notes_tui# Run with custom configuration
python -m notes_tui -c config/windows.yaml
# Configuration file example (config.yaml)
notes_directory: "./my-notes"
templates_directory: "./templates"
editor:
default: "nvim"
alternatives: ["vim", "nano"]Start writing faster with professional note templates
All-purpose template with sections, references, and related notes.
Track your daily thoughts, accomplishments, and reflections.
Capture agendas, discussions, and action items from meetings.
Plan and track projects with milestones, tasks, and stakeholders.
Document educational content with examples and practice exercises.
Track income, expenses, and savings with detailed tables.
Everything you need to know to get the most out of Notes TUI
Join developers who manage their notes efficiently in the terminal