Obsidian Stats logoObsidian Stats

Ripple

by Johan Mensah
5
4
3
2
1
Score: 50/100
Install Code

Description

A micro-journal for Obsidian in the spirit of Pile: a feed over one folder of plain Markdown, threads, highlights, and optional AI reflections.

Reviews

No reviews yet.

Stats

1
stars
1,091
downloads
0
forks
80
days
80
days
80
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
1
total issues
0
open issues
1
closed issues
39
commits

Latest Version

0.2.1
3 months ago

Changelog

What changed

  • Make Obsidian's bundled Moment type explicit so external source audits retain strict typing without changing runtime behaviour.
  • Isolate the documented Obsidian 1.12.7 settings fallback while using searchable setting definitions on 1.13 and newer.
  • Remove a redundant mobile composer CSS fallback.
  • Update the release workflow to current Node 24-based actions pinned to immutable commits.

Ripple remains compatible with Obsidian 1.12.7 and newer.

Full changelog: https://github.com/johanmensah/obsidian-ripple/compare/0.2.0...0.2.1

See all version on GitHub

README file from

Github

Ripple

The Ripple feed

A micro-journal inside your Obsidian vault, in the spirit of Pile by Udara Jay: one folder of plain Markdown posts, a feed with a composer, threaded replies, highlights, and AI reflections using the AI providers plugin.

Ripple is an independent project inspired by Pile; it is not affiliated with or endorsed by Pile or Udara Jay.

What's new in 0.2.1

  • Branch-aware threads show continuations and side branches as a tree, with separate controls to collapse a branch or every note below a fork. Branches can be temporarily flattened and restored without changing their saved relationships.

  • Scoped reflections Reflections can consider one note, a thread up to a selected point, one terminal branch, or the whole tree. Prompts retain note times and parent relationships, and an in-progress reflection returns when Ripple is reopened.

  • Thread and branch exports preserve the visible tree as configurable timestamped Markdown rows. Collapsed notes stay out of the export, nested branches retain their depth, and export names are collision-safe.

  • Safer writing retains post, reply, and edit drafts when a vault write fails and retries timestamp filename collisions.

  • Bug fixes

Navigation

  • One linked folder (default Ripple/, changeable in settings): posts land as YYYY/MM/YYYYMMDD-HHmmss.md with a small frontmatter block. Files dropped in by any other route appear in the feed.

  • Feed: newest-first under day headers, composer pinned on top, a month scrubber on the edge. In a composer, Enter posts or saves and Shift-Enter starts a new line. With the feed focused, n opens the composer, j/k move between threads, Enter edits the newest note, r replies to it, h cycles its highlight, t names it, and o opens it normally.

  • Reflections: optional AI replies via the AI Providers plugin

Development

npm install
npm run fixtures   # creates dev-vault/ and seeds it with sample posts
npm run dev        # watch build; every rebuild lands in dev-vault automatically

Open dev-vault/ as a vault in Obsidian and choose "Trust author and enable plugins" — Ripple is live; reload Obsidian after changes. npm run build typechecks and bundles for production, and npm run lint must stay clean.

To try reflections while developing, install the AI Providers plugin in the dev vault and configure any provider (a local Ollama works well). The dev vault is gitignored and disposable; never point the build at a real vault.

Sponsors