Racha

Write something every day, without guilt.

Racha (Spanish for "streak") is an Obsidian plugin built on one idea: people stop journaling because of friction and guilt, not because of a lack of motivation. So Racha makes it very easy to start, very easy to come back, and never punishes you.

🇪🇸 Léeme en español

Features

• A day is "saved" with a tiny minimum (15 words by default) plus an optional daily goal (200 words by default).
• Today's note in one click. A ribbon icon or a command opens (or creates) today's daily note with the cursor ready to type.
• Quick capture. One sentence, press Enter, done. It is appended to today's note and counts toward your day. Tappable starters like "Today I feel…" for the days you have no idea what to write.
• Streak in the status bar: 🔥 12 · 45/200, with a clear ✓ when the day is saved and 🎯 when the goal is reached. A streak of 0 shows a 🌱, never a red zero.
• Freezes. 0–2 days off per week that don't break your streak (they don't add to it either).
• Heatmap and stats. Last 16 weeks (Monday first, 5 intensity levels), current and best streak, days written, words this month, and comebacks (times you picked the habit back up).
• Gentle messages, never guilt. Coming back after 2+ days away shows "You're back. One sentence is enough today." A discreet toast when you save the day or reach the goal.
• Daily reminder at a time you choose (default 21:00). It shows once a day, and only if you haven't reached the minimum. Uses an Obsidian notice plus a system notification on desktop.
• Shareable card. Generates an image of your streak and heatmap (dark, light or color; square, vertical or horizontal). It only contains numbers, never your notes. Copy it or save it to your vault.
• Optional question of the day. A writing prompt in its own callout (63 questions in English and Spanish) and a command to swap it.
• Mobile friendly (isDesktopOnly: false) and theme friendly (it only uses Obsidian CSS variables).
• English and Spanish. Follows the Obsidian language or pick one in the settings.

How words are counted

Only what you write counts. Racha excludes the frontmatter, the question callout, %% comments %%, HTML comments, URLs, headings that contain a date (typical template text), and whatever was already in the note when it was created from a template (a baseline is stored at creation time).

The word history is stored per day in the plugin data and rebuilt from your daily notes every time Obsidian starts.

Compatibility

• Daily notes (core plugin): if enabled, Racha uses its folder, date format and template. Otherwise it uses its own settings.
• Templater: if your daily template contains Templater syntax (<% %>), Racha doesn't copy it raw: it creates an empty note in the daily folder and lets Templater's folder template fill it, as if you had created it by hand.
• Notes named YYYY-MM-DD or DD-MM-YYYY are recognized in addition to your configured format.

Installation

From the community plugins browser

Pending approval. Once listed: Settings → Community plugins → Browse → search "Racha" → Install → Enable.

With BRAT (beta)

1. Install the BRAT plugin.
2. Add the beta plugin marcosmoralesperez22/obsidian-racha.

Manual

1. Download main.js, manifest.json and styles.css from the latest release.
2. Copy them to <your vault>/.obsidian/plugins/racha/.
3. Reload Obsidian and enable Racha in Settings → Community plugins.

Usage

The plugin ships no default hotkeys. Assign your own in Settings → Hotkeys (search "Racha"). The status bar doesn't exist on mobile; use the ribbon or the commands there.

Settings

Language · daily notes folder · date format · minimum words to save the day · daily goal (0 = off) · freezes per week (0–2) · insert question of the day · daily reminder and its time · brand on the shareable card.

Privacy

Racha makes no network requests and collects no telemetry. Everything stays in your vault and in the plugin's data.json. The shareable card never includes the content of your notes.

Development

Plain JavaScript, no build step.

npm install
npm test

To try it locally, copy main.js, manifest.json and styles.css into <vault>/.obsidian/plugins/racha/.

Releases are created by pushing a tag that matches the version in manifest.json (for example 1.0.0, without a leading v); the GitHub workflow attaches the three files.

Roadmap

• "A year ago today": link to what you wrote on this date in previous years.
• Weekly summary note.

License

MIT