shiori-releases

Shiori 栞

A local-first reader for PDF, Markdown, and HTML documents.

Shiori home screen

Shiori is a quiet document workspace for reading, marking up, and shipping documents without turning them into somebody else’s cloud data. PDF annotation is the core workflow, and recent builds also support Markdown and HTML viewing with tabs, per-document state, and session restore.

Highlights

PDF reading and annotation: highlights, markup tools, thumbnails, export, and local draft recovery.
Tabs for documents: open multiple PDF, Markdown, and HTML files; each tab keeps its own view state and survives relaunch until you close it.
Markdown and HTML previews: Markdown front matter is surfaced cleanly, and HTML can run in an isolated sandbox only when you choose to run it.
Desktop side tools: keep an embedded browser or terminal next to a PDF, including local shells such as cc / Claude Code when they are installed.
Local-first storage: documents, annotations, recent files, and preferences stay on your device.
Desktop and mobile targets: macOS, Windows, Linux, Android direct install, with iOS / iPadOS and Google Play distribution handled through their stores.

Screenshots

PDF workspace with thumbnails, annotations, and side panel

Tabbed workspace with PDF, Markdown, and HTML documents

PDF workspace with the embedded browser open

PDF workspace with the embedded terminal running Claude Code through cc

Markdown document preview

HTML document running in Shiori

Downloads

Installers are published on the GitHub Releases page.

Platform	Recommended package	Update path
macOS Apple Silicon	`.dmg`	Signed in-app updater
macOS Intel	`.dmg`	Signed in-app updater
Windows	`.msi`	Signed in-app updater
Linux	`.AppImage`; `.deb` for Debian / Ubuntu	`.AppImage` updater or manual package update
Android direct install	`.apk`	In-app APK update flow
Google Play	Coming soon	Google Play
iOS / iPadOS	Coming soon	App Store / TestFlight

Desktop and Android direct-install builds can update from inside Shiori. Android direct-install builds download and verify the APK before handing it to the Android package installer. Store builds are updated by their stores and are not mirrored here as .aab or .ipa files.

Agent skill

The open-source Shiori CLI skill teaches Codex, Claude Code, and other compatible coding agents how to inspect the document open in Shiori, find passages by text, add anchored annotations, and reply inside callout threads. It expects the shiori CLI to be available on PATH.

[!IMPORTANT] This skill is not usable yet because the Shiori CLI has not been released. Installing it now only prepares the agent integration for the future CLI.

Future installation instructions (after the CLI is released)

Install it globally with the cross-agent `skills` installer, then select the coding agents that should receive it: ```sh npx skills@latest add Nagi-ovo/shiori-releases --skill shiori --global ``` For local skill development, macOS and Linux contributors can instead clone this repository and link the checkout into an agent's user-level skill directory: ```sh ln -s "$(pwd)/skills/shiori" "${CODEX_HOME:-$HOME/.codex}/skills/shiori" ln -s "$(pwd)/skills/shiori" "$HOME/.claude/skills/shiori" ``` Use the line for the agent you are developing against.

The skill itself is independently available under the MIT License; that license does not apply to Shiori application or CLI binaries.

About This Repository

This repository hosts downloadable builds, updater signatures, localized release notes, screenshots, and the open-source Shiori CLI agent skill. The Shiori application source repository is private, and discussions, feature requests, and bug reports are handled outside this repo.