Tether Flowmodoro

by Phro
5
4
3
2
1
Score: 50/100

Description

Flowmodoro timer, automatic context save-states, and cognitive anchoring for Obsidian — integrated with Tether Desktop

Reviews

No reviews yet.

Stats

0
stars
20
downloads
0
forks
5
days
5
days
5
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
10
commits

Latest Version

5 days ago

Changelog

Release 1.0.1 — Tether Flowmodoro

What's New & Fixed

  • Attested Release Assets: Added GitHub SLSA build provenance attestations for main.js, manifest.json, and styles.css.
  • Security Hardening: Removed child_process shell execution so the plugin only accesses local Tether state files in ~/.local/state/tether/ for desktop/editor synchronization.
  • Obsidian Guidelines Compliance: Aligned README title (Tether Flowmodoro), sentence-case command names, CSS class visibility, and stripped extra unsupported release files.

Core Features

  • Bidirectional Flowmodoro focus/break status bar & 5-minute Micro-Start synchronized with Tether Desktop, Neovim, and VS Code
  • Automatic active note, heading, and cursor context anchoring (context_anchor.json)
  • Working memory RAM-Dump manager (Create / Auto-fill / Edit / Delete)
  • Zero-friction impulse buffer (impulses.md) & evening shutdown ritual

README file from

Github

Tether Flowmodoro

GitHub release Obsidian >= 1.0.0 License: GPL v2 GitHub

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://.
  • 🌱 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).
  • ⚡ Impulse / Side-Quest Buffer:
    • Capture stray thoughts (- [ ] [YYYY-MM-DD HH:MM] ...) to ~/.local/state/tether/impulses.md without leaving your note.
  • 🌙 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.
  • 👁️ Platform-Agnostic Focus Sync:
    • Reports Obsidian focus state to ~/.local/state/tether/editor_focus.json across Linux, macOS, and Windows.

📦 Installation

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)

  1. Download manifest.json, main.js, and styles.css from GitHub Releases.
  2. Place them into <your-vault>/.obsidian/plugins/tether-flow/.
  3. 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.json
  • ramdumps.md and impulses.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.md og avslutt dagen trygt.

📄 License

GPL-2.0 © Phrozenn1