LLR — 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)

1. Install and enable the BRAT community plugin
2. In BRAT settings, choose Add Beta plugin and enter goryugocast/llr
3. Enable LLR in community plugins

Quick Start

All you need is Toggle Task:

1. Create — run Toggle Task on an empty line → - [ ] appears
2. Start — run Toggle Task again → current time is inserted, status becomes - [/]
3. Finish — run Toggle Task once 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