README file from
GithubLLR — Live Life Recording
日本語ドキュメント: https://goryugo.com/topics/llr
An Obsidian plugin for recording task start times, finish times, and daily flow directly in Markdown. One command — Toggle Task — creates, starts, and finishes a task. No complex UI. No lock-in. Just Markdown checkboxes.
Uninstall the plugin anytime — your data stays as plain text.
Ask AI, not the manual
You only need to learn one command: Toggle Task. For everything else, ask AI.
LLR's full specification lives in this repository's docs/ folder. Tell any AI assistant to read it, and it can explain commands, walk you through workflows, and answer questions — so you don't have to memorize 13 commands yourself.
Spend your attention on recording, not on learning the tool.
Install (BRAT)
- Install and enable the BRAT community plugin
- In BRAT settings, choose Add Beta plugin and enter
goryugocast/llr - Enable LLR in community plugins
Quick Start
All you need is Toggle Task:
- Create — run
Toggle Taskon an empty line →- [ ]appears - Start — run
Toggle Taskagain → current time is inserted, status becomes- [/] - Finish — run
Toggle Taskonce more → status becomes- [x]with elapsed time

Records are Markdown checkboxes. Edit the timestamps by hand anytime — LLR recalculates automatically.
Main Commands
| Command | What it does |
|---|---|
| Toggle Task | Create → Start → Finish a task |
| Skip Task (Log Only) | Mark a task as skipped |
| Open Summary View | Show daily progress in the sidebar |
These three cover everyday use. LLR has 13 commands total — see the full documentation for details.
Task States
| State | Format |
|---|---|
| Unstarted | - [ ] Task name (estimate) |
| Running | - [/] HH:mm - Task name |
| Done | - [x] HH:mm - HH:mm (actual) Task name |
Mobile
Register Toggle Task in Obsidian's Mobile Toolbar (the icon row above the keyboard):
- Short press — Toggle Task (create / start / finish)
- Long press — Auxiliary actions (align to previous completion, reset, etc.)
Summary View
Open the summary sidebar to see running tasks, remaining estimates, and daily totals at a glance.
Documentation
- English: https://goryugo.com/en/llr/
- 日本語: https://goryugo.com/topics/llr
- For AI assistants:
docs/in this repository
Development
npm install
npm run dev # watch build
npm run build # production bundle
npm run build:sync # bundle + sync to local Obsidian vault
npm run test # run tests
License
MIT