Local-first · plain Markdown

Thoughts move fast.
Shiori keeps up.

A tiny command-line scribe for capturing notes, tending todos, and getting back to what matters.

0.2.0 · Alpha · Windows x64 · Existing 0.1.0 workspaces require a one-time notes migration.

No database.

No account.

No cloud.

Just plain text.

See it in motion

Capture now.
Sort it out later.

shiori · today

Animated terminal session demonstrating Shiori notes, todos, and daily view
01

Quick capture

Save one thought or settle into an interactive capture session. Nothing gets lost between idea and action.

02

Files you own

Notes and tasks live in ordinary Markdown. Read them anywhere, edit them with anything—even point Shiori at an Obsidian vault.

03

A clear today

Bring notes, active tasks, due dates, topics, and tags into one colorful daily view without opening another app.

Documentation by version

The right guide for your Shiori.

Shiori is developed directly on main. That branch—and its documentation—usually runs ahead of the latest user release. Run shiori version and choose the matching release guide below.

Unreleased trunk

Current main

For contributors and people building the newest source. May describe unreleased behavior.

Read the trunk guide

Three commands to begin

Your next thought already has a place to land.

Download the 0.2.0 Windows archive and checksum, verify and extract shiori.exe, then open a terminal in the folder where you want your notes.

# meet your new scribe
 .\shiori.exe init
 .\shiori.exe add my first note
 .\shiori.exe today_

Transparency note

A note on AI

Shiori uses AI as a supporting tool for planning features, reviewing ideas, and checking implementations. The code itself is owned, crafted, understood, and maintained by a human.

This is not a vibe-coded project. Shiori is developed by an experienced software engineer who enjoys writing code and takes responsibility for every technical decision.

AI is given more leeway when helping with documentation and this website, areas where its assistance is especially welcome. Ultimately, however, the project and everything published under its name remain human-directed and human-owned.