vitrinka.docs
VývojářCLI

Todo, připomínky a čas

vitrinka me je vaše vlastní místo v projektu: todo, která dozrají na podmínce vyhodnocené serverem, připomínky na konkrétní čas, milníky, vaše agenda naplánovaných dní, automatický pracovní čas, deník a brief projektu.

Todo, která dozrávají

Todo je úkol typu todo v projektu tohoto checkoutu a užitečným ho dělá jeho okamžik — to, co ho nechá dozrát. O zralosti rozhoduje server, nikdy klient: jeden vyhodnocovač odpovídá hooku SessionStart, vitrinka me schedule ripe, MCP nástroji ripe_todos i vašemu stolu, takže se todo spustí stejně, ať se díváte kamkoli.

vitrinka me todo add "Odstranit starý přepínač košíku" --when "pr 472 merged"
vitrinka me todo add "Vyměnit klíče na stagingu" --when "deployed prod"
vitrinka me todo add "Znovu projít pravidla kupónů" --when "path internal/billing/**"
vitrinka me todo add "Napsat poznámku k upgradu" --milestone "v2 beta"
vitrinka me todo list --here --compact
vitrinka me todo done 512

Vyberte nejmenší okamžik, který sedí:

OkamžikDozraje, když
--when "pr 472 merged"Se ten pull request smerguje, jak to hlásí GitHub App; closed se spustí i při zavření bez merge.
--when "release cut"Se po založení todo uzavře vydání; release next, dokud je otevřené další vydání.
--when "deployed prod"Se zaznamená nasazení do toho prostředí — volitelně konkrétního sha — přes vitrinka project deploy-mark. Merge se za nasazení nikdy nepočítá.
--when "path internal/billing/**"Session upraví odpovídající soubor; v té session to ohlásí hook PreToolUse.
--when "task 423"Někdo převezme úkol 423 — session na jeho větvi vt-423.
--when "after 331"Je úkol 331 hotový.
--milestone <name>Se dosáhne milníku.
--due YYYY-MM-DDPřijde ten den.
--trigger "<text>"Nikdy sám od sebe: próza, kterou agent posoudí podle rozdělané práce.

Text, který se nedá přečíst jako podmínka, zůstane prózou. vitrinka me todo backfill navrhne pro prózová todo projektu typované podmínky — každá přistane jako návrh k lidskému verdiktu, nic se nepřepíše potichu. --context-file připojí doprovodnou poznámku, kterou si session po týdnech přečte, než se do položky pustí (seznam ji označí [ctx]); done todo dokončí, drop ho opustí.

Připomínky

Připomínka je todo na konkrétní čas. Dozraje --lead před tím časem (výchozí jsou 2 hodiny) a s --every se může opakovat.

vitrinka me schedule add "Poslat poznámky ze sprintu" --at "fri 09:00" --every 1w
vitrinka me schedule add "Zkontrolovat canary" --in 30m
vitrinka me schedule list
vitrinka me schedule skip 530
vitrinka me schedule end 530

list roztřídí otevřené připomínky na zpožděné, dnešní, tento týden a později; move jednu přeplánuje; me todo done u opakované připomínky zaznamená splnění a posune ji na další výskyt, skip jeden výskyt přeskočí a end celou řadu ukončí.

Milníky

Milník je pojmenovaný bod, na který čeká několik todo. Jeho dosažením dozrají všechna todo, která na něj čekají — jsou odblokovaná, ne hotová.

vitrinka me todo milestone add "v2 beta" --due 2026-10-15
vitrinka me todo milestone reach "v2 beta"
vitrinka me todo milestone unreach "v2 beta"   # vrátí omyl

Používejte přesně ten název, který vypíše milestone list: podobný zápis založí druhý milník.

Kde se todo objeví

  • Na začátku session — hook SessionStart, který nainstaluje vitrinka setup, vypíše jen todo, která se pro tento repozitář spustila, takže session začíná tím, co je na řadě, a ničím jiným — hooky.
  • Při úpravách — todo s path se ohlásí, jakmile session poprvé sáhne na odpovídající soubor.
  • Agentovi — ripe_todos a complete_todo přes MCP a skill /vitrinka:me z modulu Me (/vitrinka:me [add|list|done|drop|remind|milestone]), který vyvoláte jménem.
  • Vám — váš den v aplikaci — váš den.

Vaše agenda

Agenda je váš vlastní plán dní: existující úkoly položené na den, na celý den nebo na konkrétní čas. Nikdy nezaloží úkol a odškrtnutí uzavře položku jen pro vás, aniž by posunulo stav úkolu, takže stavy revize a brány zůstanou netknuté (todo se dokončí vlastními dveřmi).

vitrinka me agenda                                  # dnes
vitrinka me agenda week --project shop
vitrinka me agenda add 4742 --tomorrow --at 09:30 --for 90m
vitrinka me agenda move 118 --to fri --all-day
vitrinka me agenda done 118
vitrinka me agenda rm 118

add přijme id úkolu, <workspace>/<id>, klíč nebo url a naplánuje úkol na dnešek, pokud --tomorrow nebo --on <day> nepojmenuje jiný den; naplánování úkolu, který už na agendě máte, přesune jeho jedinou otevřenou položku. --at začne blok na celou čtvrthodinu a --for nastaví jeho délku (výchozí je 1 hodina). Výpis u každé položky uvede ve sloupci ITEM její číslo — argument, který berou done, move a rm; rm sundá položku z jejího dne a úkol nechá být. Nedokončená položka z dřívějšího dne se ukazuje na dnešku s označením from <day>, dokud ji neodškrtnete nebo nepřesunete, a položka, jejíž úkol je hotový nebo zrušený, se ukáže odškrtnutá na svém dni. Dny se počítají v časovém pásmu tohoto stroje, jinak podle vaší předvolby časového pásma. --people čte dny jiných lidí v pracovním prostoru a --person plánuje na agendu někoho jiného (správci pracovního prostoru). Hook SessionStart vypíše Dnešek tohoto projektu vedle todo, která se spustila — všechny přepínače.

Pracovní čas

me time zaznamenává, jak dlouho lidé a agenti skutečně pracovali, bez stopek. Zapíná se na každém stroji zvlášť:

vitrinka me time enable --project shop
vitrinka me time service install   # macOS: záznam běží od přihlášení
vitrinka me time status
vitrinka me time disable

enable zaznamená váš souhlas a zaregistruje agentní hooky v Claude Code a Codexu (těm v Codexu jednou důvěřujte přes /hooks); agentní session pak samy hlásí svou činnost — prompty, volání nástrojů, zastavení — tak, jak se děje. Lidský čas pochází z nativního vzorkovače, který ukládá jen aplikaci v popředí a intervaly nečinnosti — názvy oken se na stroji porovnají s repozitáři, které jste povolili, a zahodí se; činnost, kterou nedokáže zařadit, zůstane nepřiřazená. --human=false ponechá jen čas agentů; --exclude-application pojmenuje aplikace, které se nikdy nezaznamenají. capture pustí sběr, dokud ho nezastavíte (service install to dělá od přihlášení); disable záznam okamžitě pozastaví a to, co čeká ve frontě, si nechá, aniž by to nahrál. Co se zaznamenalo, uvidíte na svém dni v aplikaci — pracovní čas.

Deník a brief

vitrinka me brief
vitrinka me diary promote 8812 --project shop

me brief vypíše brief projektu, jak vypadá z vašeho místa — co teď, co dál, co blokuje, co se změnilo, kdo drží co a návrhy od Eve — brief. me diary promote promění nahranou schůzku ve vašem deníku v úkol typu schůzka v projektu, s připojeným zvukem a přepisem.

Na této stránce