README file from
GithubTether Flowmodoro
Flowmodoro timer, automatic context save-states, RAM-dump working memory manager, and cognitive anchoring for deep work, neurodivergent minds, and focus.
Seamlessly integrated with Tether Desktop, tether.nvim, and tether-vscode.
💡 Why Tether?
Traditional productivity timers frequently fail modern knowledge workers, students, researchers, and writers—especially neurodivergent minds (ADHD, Autism/ASD, Dyslexia, and AuDHD):
| Traditional Pomodoro | Flowmodoro in tether-obsidian |
|---|---|
| Fixed timer (counts DOWN from 25m) | Open stopwatch (counts UP) — ride your flow as long as it lasts |
| Shatters hyperfocus mid-thought | Stop when mental friction rises and earn proportional break time (45:15) |
| Initiation paralysis | 5-Minute Micro-Start lowers the barrier to just five minutes |
| Context-switch amnesia | RAM-dump save-states & Context Anchors capture note, heading, and cursor line |
✨ Features
- ⏱️ Flowmodoro Status Bar & Bidirectional Desktop Sync:
- Displays live Focus count-up, 5-minute Micro-Start countdown, or earned Break countdown directly in Obsidian's status bar.
- Synchronizes in real time with Tether Desktop via
~/.local/state/tether/flow_state.json.
- ⚓ Automatic Context Anchoring:
- Records active vault, note path, nearest Markdown heading, and cursor position to
~/.local/state/tether/context_anchor.json. - Allows Tether Desktop ("Where was I?" & "Auto-fill") to recognize what you are writing or studying in Obsidian and reopen the exact note via
obsidian://.
- Records active vault, note path, nearest Markdown heading, and cursor position to
- 🌱 5-Minute Micro-Start:
- Start a low-friction 5-minute commitment right from the Tether Hub or Command Palette.
- 🧠 RAM-Dump Working Memory Manager (Create / Edit / Delete):
- Rapidly capture Now / Status / Next Step save-states (with 1-click auto-fill from your active note and heading), edit existing dumps, or delete old entries directly inside Obsidian or Tether Desktop (
~/.local/state/tether/ramdumps.md).
- Rapidly capture Now / Status / Next Step save-states (with 1-click auto-fill from your active note and heading), edit existing dumps, or delete old entries directly inside Obsidian or Tether Desktop (
- ⚡ Impulse / Side-Quest Buffer:
- Capture stray thoughts (
- [ ] [YYYY-MM-DD HH:MM] ...) to~/.local/state/tether/impulses.mdwithout leaving your note.
- Capture stray thoughts (
- 🌙 Evening Shutdown Ritual:
- Cleanly stops active flow, parks a final summary and tomorrow's first micro-step, and writes
~/.local/state/tether/last_shutdown.json.
- Cleanly stops active flow, parks a final summary and tomorrow's first micro-step, and writes
- 👁️ Platform-Agnostic Focus Sync:
- Reports Obsidian focus state to
~/.local/state/tether/editor_focus.jsonacross Linux, macOS, and Windows.
- Reports Obsidian focus state to
📦 Installation
Option 1: 1-Click from Tether Desktop (Recommended)
Open Tether Desktop → Settings (Innstillinger) → Work Apps & Context Anchoring (Arbeidsprogrammer og Kontekst-ankring), select Obsidian, and click Install Extension (Installer utvidelse). Then enable Tether Flowmodoro under Obsidian Settings → Community plugins.
Option 2: GitHub Release (Manual or BRAT)
- Download
manifest.json,main.js, andstyles.cssfrom GitHub Releases. - Place them into
<your-vault>/.obsidian/plugins/tether-flow/. - Restart Obsidian or reload Community Plugins and toggle Tether Flowmodoro on.
Note: Releases use bare semantic version tags without a v prefix (1.0.1, etc.) to match Obsidian Community Plugin & BRAT guidelines.
⌨️ Commands
| Command | Meaning | Description |
|---|---|---|
Tether Flowmodoro: Open Tether hub |
Open Tether Hub | Open quick control modal (also via Ribbon anchor icon or status bar) |
Tether Flowmodoro: Start or pause Flowmodoro |
Toggle Flowmodoro | Toggle between Focus and earned proportional Break |
Tether Flowmodoro: Start 5-minute micro-start |
5m Micro-Start | Begin a 5-minute low-barrier Micro-Start session |
Tether Flowmodoro: Reset Flowmodoro |
Reset Flowmodoro | Reset timer to Idle |
Tether Flowmodoro: Capture impulse |
Park Impulse | Capture a distracting thought to impulses.md |
Tether Flowmodoro: Manage working memory |
RAM-Dump Manager | Create, auto-fill, edit, or delete RAM-dumps |
Tether Flowmodoro: Run evening shutdown ritual |
Shutdown Ritual | Run evening shutdown and park tomorrow's first step |
🔒 Privacy & Local Filesystem Access
This desktop-only plugin makes zero network requests, includes no analytics/telemetry, and executes no external shell processes. To enable real-time local state sharing with companion tools (Tether Desktop, Neovim, and VS Code), Node.js fs is used exclusively within the user's local Tether state directory (~/.local/state/tether/ / $XDG_STATE_HOME/tether/) and user-configured impulses file (~/.config/tether/settings.json):
flow_state.json,context_anchor.json,editor_focus.json,last_shutdown.jsonramdumps.mdandimpulses.md
🔬 Scientific Foundation
Tether's Flowmodoro timing, Micro-Start initiation scaffolding, RAM-dump working memory capture, and interruption buffering are grounded in peer-reviewed research on ADHD, Autism, Dyslexia, and Universal Cognitive Ergonomics:
🇳🇴 Norsk sammendrag
Tether for Obsidian gir deg ADHD-vennlig arbeidsflyt rett i notatene dine:
- Flowmodoro i statuslinjen: Tell oppover så lenge du har flyt og opptjen pause automatisk, fullt synkronisert med Tether Desktop.
- Kontekst-ankring & RAM-dumps: Lagre, rediger og slett
[NÅ]/[STATUS]/[NESTE STEG]direkte fra aktivt notat og overskrift. - Mikrostart, Impuls-buffer & Kvelds-avslutning: Bryt dørstokkmila på 5 minutter, parkér avsporinger til
impulses.mdog avslutt dagen trygt.