English | 日本語 (Japanese)
Yarubeshitara! (やるべしたら!) is an ultra-fast, zero-dependency CLI Todo & Reflection notebook written in Rust. Capture your daily "△ Todo List" and "△ Reflection" from the terminal in under 0.1 seconds with the effortless feel of a pocket paper notepad.
I wanted the effortless feel of the paper notepad I use every single day, combined with the convenience of the terminal—so I built this completely for myself! It's a lightweight Todo & reflection app laser-focused on speed and daily usability.
Why the name Yarubeshitara! (yarube)?
"Yarubeshitara!" (やるべしたら!) is a warm, energetic phrase from the Hokkaido dialect of northern Japan meaning "Well then, let's do this!" or "Let's get to it!". Typing yarube in the terminal is a small daily nudge to turn thoughts into action.
When your task manager and your daily journal live in separate tools, a day where plans fall apart often ends with a single lingering feeling: "Today was a failure."
yarube is purposefully designed to place "what you actually did today (facts)" and "your daily reflection (emotions & introspection)" side by side on the exact same page.
- Stress Relief via Expressive Writing (Brain Dump): Pouring out impatience, fatigue, or raw thoughts with
yarube reflectexternalizes mental clutter occupying your brain's working memory and resets your mind1. - Metacognition by Pairing Facts with Feelings: Writing your reflection while looking directly at the tasks (
TODO) you actually moved forward right above it prevents excessive self-criticism and helps you regain an objective perspective (metacognition)2.
- Zero-Friction Capture (< 0.1s)
- Run
yarube Prepare slides for tomorrow(no subcommand or quotes needed) to immediately append• Prepare slides for tomorrowto today's Todo List and redraw the page with a[NEW]highlight badge. - Attach indented context/notes to the preceding task with
yarube sub "Compare Lubuntu -> Xubuntu".
- Run
- 1-Key End-of-Day Review & Automatic Migration (
yarube review)- Walk through pending tasks (
•) one by one with a single keystroke:o(DoneO),mor>(Migrate to tomorrow>),c(Cancel~), ors(Skip). - Tasks marked as Migrated (
>) are automatically carried over—along with all of their indented subtasks (- ...)—to tomorrow's journal as pending tasks (•). - Progress is saved atomically after every single item, so pressing
Ctrl+Cmid-review never loses confirmed updates.
- Walk through pending tasks (
- Free-Form Daily Reflection (
yarube reflect)- Configure your favorite GUI or terminal editor (
code --wait,nvim,vim,nano, etc.) viayarube config editorand dump your thoughts at the end of the day, or append a quick one-liner directly from the CLI.
- Configure your favorite GUI or terminal editor (
- Page-Turning Navigation & Full-Text Search
- Flip back to your previous recorded day (automatically skipping unrecorded weekends/holidays) with
yarube prev(yarube -1,yarube -2), move forward withyarube next(yarube +1), or flip pages interactively withyarube browse. - Search across all past daily logs with
yarube search <keyword>to extract matching task blocks and reflection lines with keyword highlighting.
- Flip back to your previous recorded day (automatically skipping unrecorded weekends/holidays) with
- 4 True Color Themes & Safe Unicode Symbols
- Built-in 24-bit True Color themes:
tokyo-night(default),monokai,nord, andsepia. Switch and preview instantaneously withyarube theme <name>. - Uses only universally supported standard Unicode symbols (
•,>,O,~,-,─,△)—zero Nerd Fonts or emoji dependencies, guaranteeing zero garbled characters (mojibake) across any terminal or OS.
- Built-in 24-bit True Color themes:
- Bilingual (English / Japanese) & Zero External Crates
- Automatically adapts UI messages and headers to your
LANGlocale (or explicityarube config lang en|jasetting). The Markdown parser seamlessly reads both English (#### △ Todo List/#### △ Reflection) and Japanese (#### △ やることリスト/#### △ ふりかえり) headings. - Built using 100% Rust standard library (
std) with zero external crate dependencies.
- Automatically adapts UI messages and headers to your
Each day is stored as a plain Markdown file at ~/.yarube/YYYY-MM-DD.md (customizable via $YARUBE_DIR):
### 10/17(Tue)
#### △ Todo List
O Write tests for SIT-1-1-1-001
> Spin up GitBucket on Podman
- Compare Lubuntu -> Xubuntu
• Build conversion tool for MCP
- Convert PDF -> Markdown
#### △ Reflection
Switched to EndeavourOS!
UX matters. Everything runs super smoothly and lighter than Win11.
Books are much easier to read now—time to study hard.| Symbol | Status | Description |
|---|---|---|
• |
Todo | Newly added task, or task migrated from the previous day |
O |
Done | Completed task (rendered with Dim + Strikethrough styling) |
> |
Migrated | Task migrated to the next day's Todo List |
~ |
Cancelled | Dropped / cancelled task (rendered with Dim + Strikethrough styling) |
- |
Subtask | Indented note under a parent task (migrates together with its parent) |
Because yarube has zero third-party crate dependencies, it compiles offline in ~1 second with standard cargo:
git clone <repository-url>
cd Bullet
cargo build --release
# Copy the binary to a directory in your PATH (e.g. ~/.local/bin)
cp target/release/yarube ~/.local/bin/yarube# View today's journal (auto-generates template on first run of the day)
yarube
# Add a task (with or without 't', unquoted multiple words are joined automatically)
yarube t Write tests for SIT-1-1-1-001
yarube Prepare slides for tomorrow
# Add an indented subtask / note under the most recent task
yarube sub "Convert PDF -> Markdown"# Interactive 1-key review of pending tasks (•)
# Keys: [o] Done(O) [m/>] Migrate(>) [c/~] Cancel(~) [s/Enter] Skip(•) [q/Ctrl+C] Quit
yarube review
# Open your configured editor to write in '△ Reflection'
yarube reflect
# Or append a reflection line directly from the CLI
yarube reflect Great focus session today!# Flip to previous/next recorded days (skips unrecorded days/holidays)
yarube prev # or: yarube -1
yarube -2 # 2 recorded days back
yarube next # or: yarube +1
# Interactive page-turning mode ([p/h/←] Prev [n/l/→] Next [t] Latest [q] Quit)
yarube browse
# Full-text search across all daily logs with keyword highlighting
yarube search EndeavourOS# Switch color theme and immediately preview today's journal
yarube theme tokyo-night
yarube theme monokai
yarube theme nord
yarube theme sepia
yarube theme # Interactive menu
# Configure reflection editor (Priority: config file > $VISUAL > $EDITOR > nano/notepad)
yarube config editor
yarube config editor "code --wait"
# Switch display language (English / Japanese)
yarube config lang en
yarube config lang ja| UI Element | Style | Tokyo Night (tokyo-night) |
Monokai (monokai) |
Nord (nord) |
Sepia (sepia) |
|---|---|---|---|---|---|
Date Header (### MM/DD(Day)) |
Bold | #7aa2f7 |
#66d9ef |
#88c0d0 |
#d4a373 |
Section Heading (#### △ ...) |
Bold | #bb9af7 |
#fd971f |
#81a1c1 |
#bc6c25 |
Pending Task (•) |
Normal | #c0caf5 |
#f8f8f2 |
#eceff4 |
#faedcd |
Done / Cancelled (O / ~) |
Dim + Strikethrough | #565f89 |
#75715e |
#4c566a |
#8c8275 |
Migrated Task (>) |
Normal | #e0af68 |
#e6db74 |
#ebcb8b |
#b08968 |
Subtask / Note ( -) |
Normal | #9aa5ce |
#a6e22e |
#d8dee9 |
#ddb892 |
| Reflection Body | Normal | #c0caf5 |
#f8f8f2 |
#eceff4 |
#faedcd |
[NEW] Badge |
Bold | #9ece6a |
#a6e22e |
#a3be8c |
#6b705c |
Divider Line (─) |
Dim | #3b4261 |
#49483e |
#3b4252 |
#d5bdaf |
yarube keeps its core binary ultra-fast and zero-dependency while supporting an optional, process-isolated plugin system.
Plugins live in plugins/ (or ~/.local/share/yarube/plugins and $PATH as yarube-<name> executables) and can be written in any language (Rust, Python, Bash, etc.). Saving your daily journal always takes top priority—even if a plugin is not installed or fails, your notes are safely persisted first with zero impact on core speed.
- Subcommand Delegation (
yarube <name>): Unknown subcommands automatically dispatch toyarube-<name>in your plugin directory or$PATH. - Lifecycle Hooks (
on_reflect, etc.): Afteryarube reflectsaves your entry, registered hook plugins receive a 1-line JSON payload viastdin(event,date,log_path,added_text) along with theme/locale environment variables (YARUBE_LANG,YARUBE_THEME_NAME,YARUBE_COLOR_COACH,YARUBE_LOG_PATH,YARUBE_CONFIG_PATH). - Selective Opt-In / Opt-Out: Enable, disable, or reorder plugins anytime via
~/.config/yarube/config.toml.
(More plugins will be added to plugins/ over time!)
| Plugin | Binary | Hook / Command | Description |
|---|---|---|---|
yarube-coach |
yarube-coach |
on_reflect / yarube coach |
100% local, offline CPU AI reflection coach powered by Qwen3-1.7B (GGUF) |
yarube-coach is an offline, privacy-first reflection coach powered by Candle and Qwen3-1.7B (GGUF).
When you write a daily reflection (yarube reflect), it runs entirely on your CPU with zero network calls and no GPU required, streaming back empathetic acknowledgment and one gentle question to help separate emotions from facts and deepen your metacognition:
- A Local AI Coach for "Written Meditation" (Journaling): Rather than pushing unsolicited advice,
yarube-coachfirst acknowledges how you feel and then asks just one focused question that directs your attention to concrete facts or a specific starting point. With nobody watching and 100% offline privacy, you can deepen your "written meditation" in a completely safe space3.
#### △ Reflection
Switched to EndeavourOS! Everything runs super smoothly.
Still don't feel like writing tests for work though... only uncertain specs everywhere.
> [Coach] It sounds like you're enjoying your comfortable new OS environment, yet feeling weighed down and hesitant about testing due to all the uncertainty.
> Question: Setting the uncertain parts aside for a moment, what is the smallest piece that you know for sure right now?# Build the plugin binary (isolated from the core workspace)
cargo build --release --manifest-path plugins/yarube-coach/Cargo.toml
# Place the binary in your plugin directory or PATH (e.g. ~/.local/bin)
cp plugins/yarube-coach/target/release/yarube-coach ~/.local/bin/
# Initialize default prompt config and download the Qwen3-1.7B GGUF model & tokenizer
yarube-coach setup
# (Or generate config only and show manual curl commands without downloading)
yarube-coach setup --no-download
# Check installation status of model, tokenizer, and prompt configuration
yarube-coach status- Prompt Template: Edit
~/.config/yarube/coach_prompt.toml(auto-created bysetup) to customize the system instruction and few-shot examples ([[examples]]). If the file is missing or contains invalid syntax,yarube-coachsafely falls back to its built-in Japanese/English default prompts. - Plugin Settings (
~/.config/yarube/config.toml):[plugins.coach] enabled = true model_path = "~/.local/share/yarube/models/Qwen3-1.7B-Q8_0.gguf" tokenizer_path = "~/.local/share/yarube/models/tokenizer.json" max_tokens = 100 temperature = 0.3 top_k = 10 top_p = 0.8
yarube is structured using a clean Ports & Adapters (Layered) Architecture for high cohesion, loose coupling, and testability:
src/domain/: Pure, I/O-free domain logic (date,journal,config,navigation,search,i18n,theme)src/ports.rs: Trait abstractions (JournalRepository,ConfigRepository,EditorLauncher)src/infra/: Atomic filesystem storage (~/.yarube/YYYY-MM-DD.md,~/.yarube/config) and OS editor process launchersrc/ui/&src/cli.rs: Pure CLI argument parser, 24-bit True Color renderer, and interactive terminal controllers
# Run all 14 unit tests + 21 BDD integration tests (TP-01 through TP-21)
cargo testThis application was developed without any custom agent harnesses, pre-configured rules, or custom skills. Instead, it was built through conversational pair-programming with Antigravity driven by a single structured requirements file: Requirements.md.
We used WDD (Why-Driven Development) to structure requirements as a hierarchical Mermaid Mindmap that traces every feature from its core human motivation down to executable specifications:
- US (User Story — Why): Why the user wants the feature (e.g., "to dump thoughts at the same low friction as a handwritten '△ Todo List'")
- AC (Acceptance Criteria): What conditions must be satisfied
- TP (Test Perspective): The specific quality and boundary perspectives to verify
- BDD (Behavior-Driven Development): Concrete
Given / When / Thenscenarios - EARS (Easy Approach to Requirements Syntax): Unambiguous system behavior rules (Event-driven, State-driven, Ubiquitous, Unwanted behavior)
By evolving Requirements.md step-by-step from US-01 to US-06 and aligning on the architecture before each phase, Antigravity translated all 21 Test Perspectives (TP-01–TP-21) directly into automated integration tests and a clean, zero-dependency Rust codebase.
Footnotes
-
Expressive Writing & Working Memory: Psychological research demonstrates that writing down raw thoughts and emotions reduces intrusive rumination and frees up working memory capacity (Klein & Boals (2001), Expressive writing can increase working memory capacity; Pennebaker & Beall (1986)). ↩
-
Visualizing Small Wins (The Progress Principle): Multi-year diary studies of knowledge workers show that the single most important factor boosting daily motivation and emotional well-being is recognizing incremental progress ("Small Wins") (Teresa Amabile & Steven Kramer (2011), The Power of Small Wins, Harvard Business Review). Keeping your TODOs (facts) and Reflection (feelings) on one page ensures you never lose sight of the steps you did take, even when plans change. ↩
-
Affect Labeling & Self-Distancing (Metacognition): Putting feelings into words and stepping back to observe concrete facts dampens amygdala reactivity and fosters objective self-reflection (Lieberman et al. (2007), Putting Feelings Into Words; Kross & Ayduk (2011), Making Meaning out of Negative Experiences by Self-Distancing). ↩