Back to Catalog
nico2sh GitHub avatar

kimun

A terminal-based note-taking application for managing Markdown files with powerful search, a TUI interface, and CLI automation.

Demo

Terminal preview
kimun
Kimün Notes Preview and Search Panel Screenshot

Overview

A terminal-based note-taking application for managing Markdown files with powerful search, a TUI interface, and CLI automation.

Simple note taking, powerful search, AI ready

From the maintainer

Origin story

Most note taking apps try to do too much. This is a simple, local-first note taking app, NeoVim is great but I want something mainly focused on note taking and that's it, keeping NeoVim or VSCode or other text-related tools separated. And I want the notes to be discoverable, there's no benefit having a ton of notes and not being able to look at them: have a good, powerful search syntax and integrate them with AI tools using MCP or skills to automate note management. Oh, and a cli just for quick actions? You got it too. Ah, and if you miss Vim's keybindings, you can still use NeoVim's backend for the note taking and navigate with HJKL or do complex search and replace operations.

First workflow

If you already have an Obsidian vault or another directory with markdown notes, try Kimün on that directory, it should work right out of the box, just give it some seconds to index. Or try the example notes in the repository! Create a note, add a [[wikilink]] pointing to another note, put the cursor on top of it and press Ctrl+G and it will navigate to that note! Or it will ask you to create one if it doesn't exist. Create a new journal entry with Ctrl+J or a quick note with Ctrl+W.

Design choice

To discover and navigate notes and related ones, you don't have to rely solely on backlinks. Kimün provides a simple but powerful syntax using Markdown's formatting: You can search by exact text contained in a note, but also under a specific heading, or the text in the file name. You can exclude terms too, making it easy to create search queries that fit how you format your text: `@2025* >thoughts` will search all notes whose filename starts with `2025` and has a section with the word `thoughts` on it. Kimün also comes with an MCP server and skills so you can choose how you want to integrate the note taking system with your favorite AI tool. The skills use Kimün's CLI feature; you can also use it for quick note-taking and capturing thoughts directly from your terminal.

Roadmap

* Hashtag search * Autocomplete for links and hashtags are coming up soon * Saved searches so you can have your own filters

Latest Release

kimun-notes-v0.24.0
Released: Sep 10, 2026

Fixed

  • re-sort keeps index
  • visual regression
  • file list reorders on each refresh
  • yank on dedent
  • tab intents refactor
  • correctness

Other

  • added tests for sidebar
  • note lock on remname
  • streaming file reading
  • one app behind run()

Discussions

0 comments
Loading comments...
Alvin By Alvin