Ichigo Ichie

One day. One encounter. It will not come again.

一期一会

ichigo-ichie is a terminal companion that shows one quote per day. Add it to your shell config. Open your terminal. Read one line. Start your day.

The same day always shows the same quote. A different day shows a different one. That's the point.

Table of Contents

Features

Feature Description
One Quote Per Day Deterministic: same date = same quote. Different date = different quote.
Shell Integration One line in .bashrc / .zshrc. Zero friction.
120 Curated Quotes On impermanence, presence, and the unrepeatable nature of each moment.
Custom Quotes Add, list, and remove your own.
Zero Dependencies Ruby stdlib only (pstore, date).
Offline Only No network. No accounts. No telemetry.

Installation

gem install ichigo-ichie

Requirements

  • Ruby >= 3.0.0

No external gems required.

Quick Start

ichigo

That's it. You get one quote. Come back tomorrow for the next one.

$ ichigo
The tea cools whether you drink it or not.

$ ichigo
The tea cools whether you drink it or not.

(next day)
$ ichigo
You are not promised the evening.

Shell Integration

Add one line to your shell config:

Bash (~/.bashrc)

ichigo

Zsh (~/.zshrc)

ichigo

Fish (~/.config/fish/config.fish)

ichigo

Every time you open a new terminal, you see one line. That's all.

Commands

Default (no command)

ichigo

Shows today's quote. This is the primary use case.

tomorrow — Peek Ahead

ichigo tomorrow

See what tomorrow holds. Useful if you are impatient, but that defeats the purpose.

date — Specific Date

ichigo date 2026-12-25

Show the quote assigned to any date. Format: YYYY-MM-DD.

add — Add a Quote

ichigo add "Your custom quote here."
  • Maximum 200 characters.
  • Duplicates are rejected.

list — List All Quotes

ichigo list

Shows all quotes with their IDs.

remove — Remove a Quote

ichigo remove 42

Delete a quote by its ID.

count — Total Quotes

ichigo count

Shows how many quotes are in the database.

setup — Print Shell Instructions

ichigo setup

Prints the lines to add to your shell config.

Quote Database

Quotes are stored in a local PStore database at ~/.config/ichigo-ichie/quotes.db.

On first run, the database is seeded with 120 curated quotes about:

  • Impermanence — things pass, whether you notice or not
  • Presence — what is in front of you right now
  • Mortality — you will not get a cleaner draft of today
  • Mono no aware (物の哀れ) — the bittersweet awareness of transience

The day-of-year (1-366) determines which quote is shown. The mapping wraps around the quote pool, so every day always maps to exactly one quote.

Adding or removing quotes changes the pool, which may shift which quote appears on which day.

Configuration & Data Location

Platform Path
Linux / macOS ~/.config/ichigo-ichie/quotes.db
Windows %USERPROFILE%\.config\ichigo-ichie\quotes.db

The directory is created automatically on first run.

Development

Setup

git clone https://github.com/YumaKakuya/ichigo-ichie.git
cd ichigo-ichie

Running Locally

ruby -Ilib bin/ichigo

Building the Gem

gem build ichigo-ichie.gemspec
  • zen-and-musashi — Japanese wisdom for your terminal
  • ronin — Focus timer for the solo developer

License

MIT License. See LICENSE for the full text.

This hour will not come again.