Free and open source / for Obsidian

The social layer
for Obsidian.

Turn your vault into a living profile that updates itself every day. Then connect with friends' vaults: share notes, ask for help, offer help, and give gravity to the people who show up for you.

Private by default. Nothing leaves your vault unless you choose it. Privacy Policy

01

A living profile

Caldera reads your vault on your device and builds a profile page: a daily journal you can flip through, an activity score, topics, and the notes you choose to share.

02

A reason to check in

Every morning: what you did yesterday, how it compares to the day before, your streak, and your best days. Bring your own data from calendar, email or git.

03

Friends between vaults

Add friends by handle. Share any note as an end-to-end encrypted card; it lands in their vault as a normal note and updates when you edit it.

04

Asks and offers

Post what you could use help with and what you can help with. Put a bounty of help credits on an ask and award it to whoever helps.

05

Gravity, positive only

No likes, no downvotes. Give gravity to people who helped you. It fades over a month, so recent help counts most.

06

Open protocol

Your identity is a key that lives in your vault, not an account. Everything is signed. Self-host your page or your own hub.

Private by default

Install

One paste. Your AI does the rest.

Works with Claude Code, Codex, Cursor, or any AI agent that can edit files on your computer.

  1. 1
    Copy the promptOne click, below.
  2. 2
    Paste it into your agentIt installs Caldera and sets up your daily journal.
  3. 3
    Restart ObsidianClick Create identity. Your key never passes through the AI.
caldera-setup.md
  • Installs the plugin
  • Writes a daily journal entry
  • Counts your activity
  • Privacy rules override everything
  • Never touches your key

Already installed? In Obsidian, run Caldera: Copy AI agent setup prompt for a version pre-filled with your vault path, handle and topics.

Prefer to install by hand?

1 · Get the plugin

  1. Download caldera-0.1.0.zip.
  2. In your vault, open the hidden folder .obsidian/plugins/ and create a folder named caldera. On a Mac, Cmd+Shift+. shows hidden folders in Finder.
  3. Unzip into it: you should see main.js, manifest.json and styles.css.
  4. Restart Obsidian, then Settings → Community plugins → turn on Caldera.

Once listed in the community directory: Settings → Community plugins → Browse → search Caldera.

2 · Set it up

  1. Settings → Caldera → Create identity, then Export recovery key and keep it safe.
  2. Pick a handle and name, and optionally an avatar and banner from your vault.
  3. Choose what's public with the section switches and Public topics.
  4. Run Caldera: Preview my public profile, then Publish my profile.
  5. Open the flame icon panel to add friends and give gravity.

Optional · after setup

Make it richer

A second prompt that suggests notes to show, topics, activity sources, a 14-day journal backfill, and asks and offers. It asks before anything becomes public.

caldera-richer.md
  • Suggests public notes
  • Picks safe topics
  • Connects activity sources
  • Backfills 14 days
  • Asks before publishing

In Obsidian: Caldera: Copy AI prompt: make my profile richer.

Or do it by hand: what each convention does
Add thisTo get
caldera: public in a note's propertiesThe note listed on your profile (title and first paragraph)
caldera_headline, caldera_focus, caldera_wins in a daily note named YYYY-MM-DDThat day's journal entry
Caldera/activity.jsonDaily counts from outside tools (meetings, emails sent, commits, AI sessions) for your score
Command: Share this note with a friendAn encrypted copy in their vault, under Caldera/Inbox/
Commands: Post an ask / Post an offerThe help exchange on your profile and the hub

Publishing from a server or a scheduled job: the Caldera CLI in the repository (packages/cli, caldera publish --vault /path/to/vault) uses the same settings and identity.

Questions

Is it free?

Yes. The plugin, your profile and friends are free and open source. Optional paid features (like a hosted AI journal and custom domains) may come later.

Who can see my notes?

Only what you publish. Your vault is read on your device; Caldera publishes the sections you switch on and notes you mark caldera: public. Notes you share with a friend are encrypted so only that friend can read them.

What are help credits?

Points you earn by helping people with their asks. Everyone starts with 100. They have no cash value and can't be bought or sold.

Does it work on mobile?

Yes, the plugin runs on Obsidian desktop and mobile.

Can I host it myself?

Yes. Use Export profile to a vault folder to get a static site for any host, or run your own hub. The protocol is open.

How do I delete my profile?

In Obsidian, run Caldera: Delete my profile from the hub. Your page, friendships, asks, offers, gravity and credits on the hub are erased. Your vault is never touched.

What if I lose my device?

Your identity is a key in your vault's plugin settings. Export the recovery key when you set up, and import it on a new device.