thcThought Control

Every view

The seven views along the top, what each is for, and how to make Today your own.

thc with no arguments opens the app. Seven views sit along the top. Press 1–7, Tab and ⇧Tab to step through them, or click a tab. The bottom row always shows the keys that work right now. F1 (or ? outside writing) shows all of them.

 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1

1 · Today

What needs you now, from every page, every day and every vault:

  • Overdue (red)
  • Today: due, scheduled, or a reminder firing
  • Doing
  • Next 7 days
  • Done today
DoKey
Mark donex
Change the due / scheduled dated / s
Set the priorityp, then h m l
Tag#
Move it somewherem
Open it where it livesEnter
Add somethinga
Today ⇄ agenda (a week, by day)w
The day or week before / after[ ] / { }
Snooze or acknowledge a reminderz / Z
Choose which vaults it shows*, or click the scope in the header
See how it’s built?

When a reminder fires while you’re in thc, a toast offers x done z snooze Z ack. From the shell, thc today and thc agenda --days 7 print the same thing, and --why says why each row is there (← scheduled · repeating).

 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
───────────────━━━━━━━──────────────────────────────────────────────────────────────────────────────
 Today  2                                                                                           
▌ 23dea  [ ] Replace furnace filter                                         today · ↻ 3mo! · ¶ Home 
  xtews  [ ] Water plants                                                     today · ↻ 3d · ¶ Home 
                                                                                                    
 Next 7 days  7                                                                                     
  edx71  [ ] Summarize unread newsletters into [[Reading List]]             due tomorrow · ◆ claude 
  fk5x2  [ ] Draft Q4 OKRs                         mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning 
  ykwkc  [ ] Collect last quarter's metrics                                 due tue · ¶ Q4 Planning 
  1x3db  [ ] Pay rent                                                       tue 09:00 ◎ · ↻ monthly 
  qz8ze   ·  Dentist appointment [[Health]]                                               tue 14:00 
  pa3e6  [ ] Review draft with the team                                     due fri · ¶ Q4 Planning 
  ny82x  [ ] Call dentist to reschedule #health                                     due fri · !high 
                                                                                                    
 Done today  1                                                                                      
  k00ht  [x] Renew passport #admin                                                            10:41 
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 today · 12 open · 2 inbox      ● live   x done  a add  w agenda  space leader  ? keys   thc 0.9.65 
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
───────────────━━━━━━━──────────────────────────────────────────────────────────────────────────────
 Today  2                                                                                           
▌ 23dea  [ ] Replace furnace filter                                         today · ↻ 3mo! · ¶ Home 
  xtews  [ ] Water plants                                                     today · ↻ 3d · ¶ Home 
                                                                                                    
 Next 7 days  7                                                                                     
  edx71  [ ] Summarize unread newsletters into [[Reading List]]             due tomorrow · ◆ claude 
  fk5x2  [ ] Draft Q4 OKRs                         mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning 
  ykwkc  [ ] Collect last quarter's metrics                                 due tue · ¶ Q4 Planning 
  1x3db  [ ] Pay rent                                                       tue 09:00 ◎ · ↻ monthly 
  qz8ze   ·  Dentist appointment [[Health]]                                               tue 14:00 
  pa3e6  [ ] Review draft with the team                                     due fri · ¶ Q4 Planning 
  ny82x  [ ] Call dentist to reschedule #health                                     due fri · !high 
                                                                                                    
 Done today  1                                                                                      
  k00ht  [x] Renew passport #admin                                                            10:41 
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 today · 12 open · 2 inbox      ● live   x done  a add  w agenda  space leader  ? keys   thc 0.9.65 
Today: what's due now, then the next seven days, then what you finished.

Across vaults, every line says where it’s from. With more than one vault, each row ends with its vault’s name in that vault’s colour, and the header says which vaults Today covers (Today · all vaults (3)). Press * to choose: all vaults, just this one, or a checkbox per vault. The choice is for this device; s in the picker makes it the default everywhere.

 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1                  Sat Oct 3 · 10:41 
───────────────━━━━━━━────────────────────────────────────────────────────────────────────────────────────────
 Today · all vaults (3)                                                            * scope   ? how it's built 
 Today  4                                                                                                     
▌ 23dea  [ ] Replace furnace filter                                        today · ↻ 3mo! · ¶ Home   personal 
  xtews  [ ] Water plants                                                    today · ↻ 3d · ¶ Home   personal 
  6e3yb  [ ] Fix the flaky login test #api                                       due today · !high        dev 
  6e95d  [ ] Draft the Q4 budget                                                         due today       acme 
                                                                                                              
 Next 7 days  9                                                                                               
  edx71  [ ] Summarize unread newsletters into [[Reading List]]            due tomorrow · ◆ claude   personal 
  fk5x2  [ ] Draft Q4 OKRs                        mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning   personal 
  ykwkc  [ ] Collect last quarter's metrics                                due tue · ¶ Q4 Planning   personal 
  6e3yh  [ ] Review the migration PR                                                       due tue        dev 
  1x3db  [ ] Pay rent                                                      tue 09:00 ◎ · ↻ monthly   personal 
  qz8ze   ·  Dentist appointment [[Health]]                                              tue 14:00   personal 
  pa3e6  [ ] Review draft with the team                                    due fri · ¶ Q4 Planning   personal 
  ny82x  [ ] Call dentist to reschedule #health                                    due fri · !high   personal 
  6e95k  [ ] Send the invoice                                                      due fri · !high       acme 
                                                                                                              
 Done today  1                                                                                                
  k00ht  [x] Renew passport #admin                                                           10:41   personal 
                                                                                                              
 today · 3 vaults · 16 open · 2 inbox     ● live   x done  a add  w agenda  space leader  ? keys   thc 0.9.65 
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1                  Sat Oct 3 · 10:41 
───────────────━━━━━━━────────────────────────────────────────────────────────────────────────────────────────
 Today · all vaults (3)                                                            * scope   ? how it's built 
 Today  4                                                                                                     
▌ 23dea  [ ] Replace furnace filter                                        today · ↻ 3mo! · ¶ Home   personal 
  xtews  [ ] Water plants                                                    today · ↻ 3d · ¶ Home   personal 
  6e3yb  [ ] Fix the flaky login test #api                                       due today · !high        dev 
  6e95d  [ ] Draft the Q4 budget                                                         due today       acme 
                                                                                                              
 Next 7 days  9                                                                                               
  edx71  [ ] Summarize unread newsletters into [[Reading List]]            due tomorrow · ◆ claude   personal 
  fk5x2  [ ] Draft Q4 OKRs                        mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning   personal 
  ykwkc  [ ] Collect last quarter's metrics                                due tue · ¶ Q4 Planning   personal 
  6e3yh  [ ] Review the migration PR                                                       due tue        dev 
  1x3db  [ ] Pay rent                                                      tue 09:00 ◎ · ↻ monthly   personal 
  qz8ze   ·  Dentist appointment [[Health]]                                              tue 14:00   personal 
  pa3e6  [ ] Review draft with the team                                    due fri · ¶ Q4 Planning   personal 
  ny82x  [ ] Call dentist to reschedule #health                                    due fri · !high   personal 
  6e95k  [ ] Send the invoice                                                      due fri · !high       acme 
                                                                                                              
 Done today  1                                                                                                
  k00ht  [x] Renew passport #admin                                                           10:41   personal 
                                                                                                              
 today · 3 vaults · 16 open · 2 inbox     ● live   x done  a add  w agenda  space leader  ? keys   thc 0.9.65 
Today across three vaults: each line ends with its vault, in its colour.
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1                  Sat Oct 3 · 10:41 
───────────────━━━━━━━────────────────────────────────────────────────────────────────────────────────────────
 Today · all vaults (3)                                                            * scope   ? how it's built 
 Today  4                                                                                                     
▌ 23dea  [ ] Replace furnace ╭─ Today · scope ──────────────────────────────────╮· ↻ 3mo! · ¶ Home   personal 
  xtews  [ ] Water plants    │ ● all vaults                                   a │y · ↻ 3d · ¶ Home   personal 
  6e3yb  [ ] Fix the flaky lo│ ○ this vault (personal)                        . │due today · !high        dev 
  6e95d  [ ] Draft the Q4 bud│ ──────────────────────────────────────────────── │        due today       acme 
                             │ [x] personal                                     │                             
 Next 7 days  9              │ [x] acme                                         │                             
  edx71  [ ] Summarize unread│ [x] dev                                          │morrow · ◆ claude   personal 
  fk5x2  [ ] Draft Q4 OKRs   ╰── Space toggle · Enter done · s save as default ─╯h · ¶ Q4 Planning   personal 
  ykwkc  [ ] Collect last quarter's metrics                                due tue · ¶ Q4 Planning   personal 
  6e3yh  [ ] Review the migration PR                                                       due tue        dev 
  1x3db  [ ] Pay rent                                                      tue 09:00 ◎ · ↻ monthly   personal 
  qz8ze   ·  Dentist appointment [[Health]]                                              tue 14:00   personal 
  pa3e6  [ ] Review draft with the team                                    due fri · ¶ Q4 Planning   personal 
  ny82x  [ ] Call dentist to reschedule #health                                    due fri · !high   personal 
  6e95k  [ ] Send the invoice                                                      due fri · !high       acme 
                                                                                                              
 Done today  1                                                                                                
  k00ht  [x] Renew passport #admin                                                           10:41   personal 
                                                                                                              
 scope                                                                                                        
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1                  Sat Oct 3 · 10:41 
───────────────━━━━━━━────────────────────────────────────────────────────────────────────────────────────────
 Today · all vaults (3)                                                            * scope   ? how it's built 
 Today  4                                                                                                     
▌ 23dea  [ ] Replace furnace ╭─ Today · scope ──────────────────────────────────╮· ↻ 3mo! · ¶ Home   personal 
  xtews  [ ] Water plants    │ ● all vaults                                   a │y · ↻ 3d · ¶ Home   personal 
  6e3yb  [ ] Fix the flaky lo│ ○ this vault (personal)                        . │due today · !high        dev 
  6e95d  [ ] Draft the Q4 bud│ ──────────────────────────────────────────────── │        due today       acme 
                             │ [x] personal                                     │                             
 Next 7 days  9              │ [x] acme                                         │                             
  edx71  [ ] Summarize unread│ [x] dev                                          │morrow · ◆ claude   personal 
  fk5x2  [ ] Draft Q4 OKRs   ╰── Space toggle · Enter done · s save as default ─╯h · ¶ Q4 Planning   personal 
  ykwkc  [ ] Collect last quarter's metrics                                due tue · ¶ Q4 Planning   personal 
  6e3yh  [ ] Review the migration PR                                                       due tue        dev 
  1x3db  [ ] Pay rent                                                      tue 09:00 ◎ · ↻ monthly   personal 
  qz8ze   ·  Dentist appointment [[Health]]                                              tue 14:00   personal 
  pa3e6  [ ] Review draft with the team                                    due fri · ¶ Q4 Planning   personal 
  ny82x  [ ] Call dentist to reschedule #health                                    due fri · !high   personal 
  6e95k  [ ] Send the invoice                                                      due fri · !high       acme 
                                                                                                              
 Done today  1                                                                                                
  k00ht  [x] Renew passport #admin                                                           10:41   personal 
                                                                                                              
 scope                                                                                                        
* chooses which vaults Today shows on this device.

Every view explains itself. ? on Today, Inbox, Tasks or a saved view shows how it’s built: each section, how many it holds, its query, and what that means with the dates filled in. e edits it in your editor (as Title · query lines), c copies it as a new view, and r puts a built-in one back. ? again shows the keys.

 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1                  Sat Oct 3 · 10:41 
───────────────━━━━━━━────────────────────────────────────────────────────────────────────────────────────────
 Today · all vaults (3)                                                            * scope   ? how it's built 
 T╭─ @today · built-in ────────────────────────────────────────────────────────────────────────────────────╮  
▌ │ scope  all vaults (3): personal, acme, dev                                                             │l 
  │ ────────────────────────────────────────────────────────────────────────────────────────────────────── │l 
  │ Overdue       0  is:overdue status:open                     overdue (open, due before Sat Oct 3), and  │v 
  │                                                             open tasks                                 │e 
  │ Today         4  (sched<=today or due=today or is:alert)    (scheduled on or before Sat Oct 3, or due  │  
 N│                  status:open -is:overdue                    on Sat Oct 3, or with an alert), and open  │  
  │                                                             tasks, and not overdue (open, due before   │l 
  │                                                             Sat Oct 3)                                 │l 
  │ Doing         0  status:doing                               status doing                               │l 
  │ Next 7 days   9  happens<=+7d happens>today status:open     happens on or before Sat Oct 10            │v 
  │                                                             (scheduled, due or an alert), and happens  │l 
  │                                                             after Sat Oct 3 (scheduled, due or an      │l 
  │                                                             alert), and open tasks                     │l 
  │ Done today    1  done>=today                                done on or after Sat Oct 3                 │l 
  │ ────────────────────────────────────────────────────────────────────────────────────────────────────── │e 
  │ A note shows once, in its first matching section · each section keeps its own sort                     │  
 D╰───────────────────────────────────────────────────────────── e edit · c copy · * scope · ? keys · Esc ─╯  
  k00ht  [x] Renew passport #admin                                                           10:41   personal 
                                                                                                              
 how it's built                                                                                               
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1                  Sat Oct 3 · 10:41 
───────────────━━━━━━━────────────────────────────────────────────────────────────────────────────────────────
 Today · all vaults (3)                                                            * scope   ? how it's built 
 T╭─ @today · built-in ────────────────────────────────────────────────────────────────────────────────────╮  
▌ │ scope  all vaults (3): personal, acme, dev                                                             │l 
  │ ────────────────────────────────────────────────────────────────────────────────────────────────────── │l 
  │ Overdue       0  is:overdue status:open                     overdue (open, due before Sat Oct 3), and  │v 
  │                                                             open tasks                                 │e 
  │ Today         4  (sched<=today or due=today or is:alert)    (scheduled on or before Sat Oct 3, or due  │  
 N│                  status:open -is:overdue                    on Sat Oct 3, or with an alert), and open  │  
  │                                                             tasks, and not overdue (open, due before   │l 
  │                                                             Sat Oct 3)                                 │l 
  │ Doing         0  status:doing                               status doing                               │l 
  │ Next 7 days   9  happens<=+7d happens>today status:open     happens on or before Sat Oct 10            │v 
  │                                                             (scheduled, due or an alert), and happens  │l 
  │                                                             after Sat Oct 3 (scheduled, due or an      │l 
  │                                                             alert), and open tasks                     │l 
  │ Done today    1  done>=today                                done on or after Sat Oct 3                 │l 
  │ ────────────────────────────────────────────────────────────────────────────────────────────────────── │e 
  │ A note shows once, in its first matching section · each section keeps its own sort                     │  
 D╰───────────────────────────────────────────────────────────── e edit · c copy · * scope · ? keys · Esc ─╯  
  k00ht  [x] Renew passport #admin                                                           10:41   personal 
                                                                                                              
 how it's built                                                                                               
? on Today: each section with its count, its query, and what it means with the dates filled in.

Lists keep their order. Clicking, opening and coming back never reshuffle a list. A task you finish stays where it is, dimmed, until you come back to the view (or press ⌃L), and something an agent adds appears without moving your selection. Only a sort change reorders on screen.

2 · Inbox

Things captured without a home: from thc add --inbox, from agents, or from the drop/ folder in your vault (save a .md or .txt file there from your phone, and each paragraph or list item becomes an inbox item). Triage each one with m (move to a page or day), t (make it a task), d (give it a date), x (done) or D (delete). The cursor moves on after each, so triage is fast.

3 · Tasks

Every open task, filtered by a query. Press f (or /) and type, for example status:open #work due<=+7d sort:due. Saved views sit on a row under 1–9. At 120 columns the list becomes a table with due, scheduled, priority, where and who. Press , to change the sort. Esc closes the filter without wiping your query.

The language is the same everywhere: here, in thc q, and in saved views. See Query language.

 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
─────────────────────────────────━━━━━━━────────────────────────────────────────────────────────────
 q› status:open sort:due                                                                   12 tasks 
                                                                                                    
▌ edx71  [ ] Summarize unread newsletters into [[Reading List]]             due tomorrow · ◆ claude 
  ykwkc  [ ] Collect last quarter's metrics                                 due tue · ¶ Q4 Planning 
  pa3e6  [ ] Review draft with the team                                     due fri · ¶ Q4 Planning 
  ny82x  [ ] Call dentist to reschedule #health                                     due fri · !high 
  fk5x2  [ ] Draft Q4 OKRs                         mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning 
  qn6jb  [ ] Schedule annual physical                                due Oct 13 (in 10d) · ¶ Health 
  xtews  [ ] Water plants                                                     today · ↻ 3d · ¶ Home 
  23dea  [ ] Replace furnace filter                                         today · ↻ 3mo! · ¶ Home 
  1x3db  [ ] Pay rent                                                       tue 09:00 ◎ · ↻ monthly 
  xhb6p  [ ] Refill prescription                      Oct 15 (in 12d) · !med · ↻ monthly · ¶ Health 
  6cvvf  [ ] Fix leaky kitchen faucet                                                 !low · ¶ Home 
  zb4ha  [ ] Read The Pragmatic Programmer, ch. 1-3                                  ¶ Reading List 
                                                                                                    
 saved  1 open  2 this week  3 waiting  4 by claude  5 ready                             f then 1-5 
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 tasks · status:open sort:due  ● live   f filter  , sort  x done  space leader  ? keys   thc 0.9.65 
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
─────────────────────────────────━━━━━━━────────────────────────────────────────────────────────────
 q› status:open sort:due                                                                   12 tasks 
                                                                                                    
▌ edx71  [ ] Summarize unread newsletters into [[Reading List]]             due tomorrow · ◆ claude 
  ykwkc  [ ] Collect last quarter's metrics                                 due tue · ¶ Q4 Planning 
  pa3e6  [ ] Review draft with the team                                     due fri · ¶ Q4 Planning 
  ny82x  [ ] Call dentist to reschedule #health                                     due fri · !high 
  fk5x2  [ ] Draft Q4 OKRs                         mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning 
  qn6jb  [ ] Schedule annual physical                                due Oct 13 (in 10d) · ¶ Health 
  xtews  [ ] Water plants                                                     today · ↻ 3d · ¶ Home 
  23dea  [ ] Replace furnace filter                                         today · ↻ 3mo! · ¶ Home 
  1x3db  [ ] Pay rent                                                       tue 09:00 ◎ · ↻ monthly 
  xhb6p  [ ] Refill prescription                      Oct 15 (in 12d) · !med · ↻ monthly · ¶ Health 
  6cvvf  [ ] Fix leaky kitchen faucet                                                 !low · ¶ Home 
  zb4ha  [ ] Read The Pragmatic Programmer, ch. 1-3                                  ¶ Reading List 
                                                                                                    
 saved  1 open  2 this week  3 waiting  4 by claude  5 ready                             f then 1-5 
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 tasks · status:open sort:due  ● live   f filter  , sort  x done  space leader  ? keys   thc 0.9.65 
Tasks, filtered by a query, with saved views on the row above.

4 · Pages

Your pages, with how many open items each has. Type to find one; Enter (or →, or a double-click) opens it in the editor. Pages are made by linking ([[Name]]) or from the finder (+ new page).

4 always shows this list, never a page. The cursor rests on the page you opened last, so 4 Enter reopens it, and Esc in a page comes back here.

Back and forward. ⌘[ and ⌘] (or ⌃⌥← / ⌃⌥→ in any terminal) move through the places you’ve been, like a browser: pages, days, views and vaults, with the cursor where you left it. :history lists them, and a click goes there. Esc is different: it goes up, to where you started (after following three links, Esc returns to the list or day you began on, while ⌘[ goes to the page before).

In a terminal 120 columns or wider, a page has a rail of your pages on its left (recent first, then A–Z, with open counts): click one to switch. A journal day gets a rail of days. Narrower, a crumb (¶ Pages › Health) sits above the title instead. page_rail = false under [tui] turns the rail off.

 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
─────────────────────────────────────────━━━━━━━────────────────────────────────────────────────────
 › type to find a page, tag or day                                                                  
                                                                                                    
 Pages  5                                                                                sort: name 
▌ 4qt7h  ¶ Atomic Habits                                                                        ← 1 
  jxwp0  ¶ Health                                                         3 children · 2 open · ← 1 
  nnxzp  ¶ Home                                                                 4 children · 3 open 
  srhd9  ¶ Q4 Planning                                                    2 children · 3 open · ← 1 
  5q875  ¶ Reading List                                                   2 children · 1 open · ← 1 
                                                                                                    
 Tags  7                                                                                            
 #admin 1   #finance 1   #gifts 1   #health 2   #personal 3   #reading 2   #work 1                  
                                                                                                    
 Journal                                                                                     recent 
 § Sat Oct 3 · 6     § Fri Oct 2 · 2     § Thu Oct 1 · 2                                            
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 pages · 5                                       ● live   Enter open  / filter  ? keys   thc 0.9.65 
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
─────────────────────────────────────────━━━━━━━────────────────────────────────────────────────────
 › type to find a page, tag or day                                                                  
                                                                                                    
 Pages  5                                                                                sort: name 
▌ 4qt7h  ¶ Atomic Habits                                                                        ← 1 
  jxwp0  ¶ Health                                                         3 children · 2 open · ← 1 
  nnxzp  ¶ Home                                                                 4 children · 3 open 
  srhd9  ¶ Q4 Planning                                                    2 children · 3 open · ← 1 
  5q875  ¶ Reading List                                                   2 children · 1 open · ← 1 
                                                                                                    
 Tags  7                                                                                            
 #admin 1   #finance 1   #gifts 1   #health 2   #personal 3   #reading 2   #work 1                  
                                                                                                    
 Journal                                                                                     recent 
 § Sat Oct 3 · 6     § Fri Oct 2 · 2     § Thu Oct 1 · 2                                            
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 pages · 5                                       ● live   Enter open  / filter  ? keys   thc 0.9.65 
The pages finder: type to narrow, Enter to open.

5 · Journal

One page per day, opened as a document you write in (see Writing). The strip under the date jumps between days: ⌃P / ⌃N, or click a day. Also today, at the bottom, shows what’s due today from other pages.

Full text across pages, tags and notes, as you type. Enter opens the match in context. From the shell: thc search "lisbon deposit".

 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
───────────────────────────────────────────────────────────━━━━━━━━─────────────────────────────────
 / health                                                                  3 nodes · 1 page · 1 tag 
                                                                                                    
 Pages  1                                                                                           
▌ jxwp0   ¶  Health                                                       3 children · 2 open · ← 1 
                                                                                                    
 Tags  1                                                                                            
  2tbj6   #  health                                                                         2 nodes 
                                                                                                    
 Nodes  3                                                                                           
  qz8ze   ·  Dentist appointment [[Health]]                                     tue 14:00 · § today 
  ny82x  [ ] Call dentist to reschedule #health                           due fri · !high · § today 
  m6e0y   ·  Morning: slept well, 30 min run #health                                        § today 
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 search · full text + titles                     ● live   Enter open  / search  ? keys   thc 0.9.65 
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
───────────────────────────────────────────────────────────━━━━━━━━─────────────────────────────────
 / health                                                                  3 nodes · 1 page · 1 tag 
                                                                                                    
 Pages  1                                                                                           
▌ jxwp0   ¶  Health                                                       3 children · 2 open · ← 1 
                                                                                                    
 Tags  1                                                                                            
  2tbj6   #  health                                                                         2 nodes 
                                                                                                    
 Nodes  3                                                                                           
  qz8ze   ·  Dentist appointment [[Health]]                                     tue 14:00 · § today 
  ny82x  [ ] Call dentist to reschedule #health                           due fri · !high · § today 
  m6e0y   ·  Morning: slept well, 30 min run #health                                        § today 
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 search · full text + titles                     ● live   Enter open  / search  ? keys   thc 0.9.65 
Search: every page, tag and note, as you type.

7 · Log

Every change, newest first: who made it (you, ◆ claude), when, and what. u undoes the selected change, as a new change: nothing is erased. @ cycles whose changes you see, and R rewinds a note to how it was.

r switches to the review lane, where agents’ changes wait for you: a accept, u undo, A accept all. See Agents.

 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
────────────────────────────────────────────────────────────────────━━━━━━━─────────────────────────
 Log · 0 tx                                              last 24h · everyone   r to review  @ actor 
                                                                                                    
   No changes in the last 24h.                                                                      
   @ pick an actor  ·  thc log --since 7d                                                           
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 log · undo makes a new tx   ● live   u undo tx  r review  @ actor  Enter open  ? keys   thc 0.9.65 
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
────────────────────────────────────────────────────────────────────━━━━━━━─────────────────────────
 Log · 0 tx                                              last 24h · everyone   r to review  @ actor 
                                                                                                    
   No changes in the last 24h.                                                                      
   @ pick an actor  ·  thc log --since 7d                                                           
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 log · undo makes a new tx   ● live   u undo tx  r review  @ actor  Enter open  ? keys   thc 0.9.65 
The Log: every change, who made it, and one key to undo it.

Views with sections

Today, Agenda, Inbox and Tasks are built-in views made of sections, each section a query. thc view ls lists them with your own. Today, as shipped:

SectionQuery
Overdueis:overdue status:open
Today(sched<=today or due=today or is:alert) status:open -is:overdue
Doingstatus:doing
Next 7 dayshappens<=+7d happens>today status:open
Done todaydone>=today

Make it yours. Sections are given in order, and replace the old ones:

$ thc view set today --section Due 'due<=today status:open' \
                     --section Waiting 'status:waiting'
$ thc view reset today              # back to the built-in

Or keep Today and make another:

$ thc view copy today acme-today
$ thc view set acme-today --scope vault:acme
$ thc q @acme-today

--scope sets the vaults every section reads (vault:*, vault:(a or b)). Today and Agenda read every vault by default; see Vaults.

Plain saved views are one query with a name:

$ thc view add work 'status:open #work sort:due' --tasks 1   # also slot 1 on the Tasks row
$ thc q @work due<=+3d                                       # views compose with more terms
$ thc view rm work                                           # thc undo brings it back

Views sync like notes, and undo like any write.

Around the edges

  • The detail pane (\, at 120+ columns): everything about the selected item, plus its history and links.
  • Contexts (C, or thc context work): show only what matches a saved view, for example only #work while you’re at work. It’s always named in the header while it’s on, so nothing is ever hidden without you knowing. It’s local to this device and never synced.
  • Vaults (V): switch between vaults, each with its own colour.
  • Focus (⌥Z while writing): hides everything but your words. Choose what stays with :focus.
  • The leader (Space, in any list): a panel shows every command, grouped by what it does. space g go, space f find, space n new, space t toggle, space v saved views. You never need to remember a key: press Space and read. ⌫ steps back, Esc closes. While writing, Space is just a space.
  • Help (F1, or ? in lists): the keys for exactly where you are, grouped. ? ? shows every key everywhere.
  • The palette (:, or space space): every command by name, with its key. Type a few letters and press Enter.
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
───────────────━━━━━━━──────────────────────────────────────────────────────────────────────────────
 Today  2                                                                                           
▌ 23dea  [ ] Replace furnace filter                                         today · ↻ 3mo! · ¶ Home 
  xtews  [ ] Water plants                                                     today · ↻ 3d · ¶ Home 
                                                                                                    
 Next 7 days  7                                                                                     
  edx71  [ ] Summarize unread newsletters into [[Reading List]]             due tomorrow · ◆ claude 
  fk5x2  [ ] Draft Q4 OKRs                         mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning 
  ykwkc  [ ] Collect last quarter's metrics                                 due tue · ¶ Q4 Planning 
  1x3db  [ ] Pay rent                                                       tue 09:00 ◎ · ↻ monthly 
  qz8ze   ·  Dentist appointment [[Health]]                                               tue 14:00 
  pa3e6  [ ] Review draft with the team                                     due fri · ¶ Q4 Planning 
  ny82x  [ ] Call dentist to reschedule #health                                     due fri · !high 
                                                                                                    
 Done today  1                                                                                      
  k00ht  [x] Renew passport #admin                                                            10:41 
                                                                                                    
                                                                                                    
─ space ────────────────────────────────────────────────────────────────────────────────────────────
 f  +find                t  +toggle              r  review lane          q  quit                    
 g  +go                  v  +views               e  $EDITOR              ?  every key               
 n  +new                 space  commands         E  $EDITOR page         a  about · what's new      
 space…                                                                          ⌫ back  Esc cancel 
 [•] personal   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 1        Sat Oct 3 · 10:41 
───────────────━━━━━━━──────────────────────────────────────────────────────────────────────────────
 Today  2                                                                                           
▌ 23dea  [ ] Replace furnace filter                                         today · ↻ 3mo! · ¶ Home 
  xtews  [ ] Water plants                                                     today · ↻ 3d · ¶ Home 
                                                                                                    
 Next 7 days  7                                                                                     
  edx71  [ ] Summarize unread newsletters into [[Reading List]]             due tomorrow · ◆ claude 
  fk5x2  [ ] Draft Q4 OKRs                         mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning 
  ykwkc  [ ] Collect last quarter's metrics                                 due tue · ¶ Q4 Planning 
  1x3db  [ ] Pay rent                                                       tue 09:00 ◎ · ↻ monthly 
  qz8ze   ·  Dentist appointment [[Health]]                                               tue 14:00 
  pa3e6  [ ] Review draft with the team                                     due fri · ¶ Q4 Planning 
  ny82x  [ ] Call dentist to reschedule #health                                     due fri · !high 
                                                                                                    
 Done today  1                                                                                      
  k00ht  [x] Renew passport #admin                                                            10:41 
                                                                                                    
                                                                                                    
─ space ────────────────────────────────────────────────────────────────────────────────────────────
 f  +find                t  +toggle              r  review lane          q  quit                    
 g  +go                  v  +views               e  $EDITOR              ?  every key               
 n  +new                 space  commands         E  $EDITOR page         a  about · what's new      
 space…                                                                          ⌫ back  Esc cancel 
Space opens the leader: every command, grouped, one letter each.

When two devices changed the same note before they synced, the header says so (≠ 2 conflicts). c on the row compares the two versions; you choose.

 [•] conflict   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 4        Sat Oct 3 · 10:41 
───────────────━━━━━━━──────────────────────────────────────────────────────────────────────────────
 ≠ 2 conflicts  qz8ze text was edited on two devices · c compare                                    
 Today  3                                                                                           
▌ xtews  [ ] Water plants                                                     today · ↻ 3d · ¶ Home 
  23dea  [ ] Replace furnace filter                                         today · ↻ 3mo! · ¶ Home 
  976d5  [ ] Stretch                                                       today 10:43 ◎ · ◆ claude 
                                                                                                    
 Next 7 days  7                                                                                     
  edx71  [ ] Summarize unread newsletters into [[Reading List]]             due tomorrow · ◆ claude 
  fk5x2  [ ] Draft Q4 OKRs                         mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning 
≠ ykwkc  [ ] Collect last quarter's metrics                                 due tue · ¶ Q4 Planning 
  1x3db  [ ] Pay rent                                                       tue 09:00 ◎ · ↻ monthly 
≠ qz8ze   ·  Dentist appointment [[Health]], moved to 15:00                               tue 14:00 
  pa3e6  [ ] Review draft with the team                                     due fri · ¶ Q4 Planning 
  ny82x  [ ] Call dentist to reschedule #health                                     due fri · !high 
                                                                                                    
 Done today  1                                                                                      
  k00ht  [x] Renew passport #admin                                                            10:41 
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 today · 13 open · 2 inbox · 2 conflicts     ● live   x done  a add  w agenda  space leader  ? keys 
 [•] conflict   Today   Inbox 2   Tasks   Pages   Journal   Search   Log 4        Sat Oct 3 · 10:41 
───────────────━━━━━━━──────────────────────────────────────────────────────────────────────────────
 ≠ 2 conflicts  qz8ze text was edited on two devices · c compare                                    
 Today  3                                                                                           
▌ xtews  [ ] Water plants                                                     today · ↻ 3d · ¶ Home 
  23dea  [ ] Replace furnace filter                                         today · ↻ 3mo! · ¶ Home 
  976d5  [ ] Stretch                                                       today 10:43 ◎ · ◆ claude 
                                                                                                    
 Next 7 days  7                                                                                     
  edx71  [ ] Summarize unread newsletters into [[Reading List]]             due tomorrow · ◆ claude 
  fk5x2  [ ] Draft Q4 OKRs                         mon · due Oct 10 (in 7d) · !high · ¶ Q4 Planning 
≠ ykwkc  [ ] Collect last quarter's metrics                                 due tue · ¶ Q4 Planning 
  1x3db  [ ] Pay rent                                                       tue 09:00 ◎ · ↻ monthly 
≠ qz8ze   ·  Dentist appointment [[Health]], moved to 15:00                               tue 14:00 
  pa3e6  [ ] Review draft with the team                                     due fri · ¶ Q4 Planning 
  ny82x  [ ] Call dentist to reschedule #health                                     due fri · !high 
                                                                                                    
 Done today  1                                                                                      
  k00ht  [x] Renew passport #admin                                                            10:41 
                                                                                                    
                                                                                                    
                                                                                                    
                                                                                                    
 today · 13 open · 2 inbox · 2 conflicts     ● live   x done  a add  w agenda  space leader  ? keys 
Two versions of one note, both kept. You decide which stays.