Beaver — Obsidian plugin

Sends the current note to Beaver's markdown frontend (POST /chat on beaver-gateway) and writes the agent's reply back into the file. Skips the Obsidian Sync round-trip by POSTing the buffer contents directly.

Commands

Both commands appear in the command palette only when the active note's YAML frontmatter has an agent: field:

Beaver: Send using selected agent — uses frontmatter.agent.
Beaver: Send using different agent — fetches the agent list from the gateway and opens a fuzzy picker.

Settings

Base URL — markdown-frontend root, e.g. http://localhost:62993.
Bearer token — a token with the messages scope (mint via the admin frontend or BOOTSTRAP_TOKENS).
Test connection — calls GET /agents.

Note format

A minimal note that the plugin can send:

---
agent: beaver-opus-medium
---

hi there

The gateway parses ### User: / ### Assistant: markers; a note with no markers is treated as a single user turn. After a successful send, the gateway returns the new file content (including an ### Assistant: block and a fresh ### User: scaffold), and the plugin writes it back to the buffer.

Install

make install VAULT=~/Obsidian/my-vault     # build + copy manifest.json + main.js into <vault>/.obsidian/plugins/beaver
make zip                                    # build → beaver-plugin-<version>.zip you can carry to any vault

Then enable Beaver in Settings → Community plugins.

Mobile

The plugin is desktop-and-mobile (isDesktopOnly: false). Two things to get right on a phone:

The base URL in plugin settings has to be reachable from the phone — http://localhost:62993 won't work; use the gateway's LAN IP, a tunnel, or a public hostname.
Get the plugin files onto the phone vault via Obsidian Sync (toggle "Installed community plugins" in your sync settings) or any file-sync tool you already use (Working Copy, Syncthing, etc.). make install only knows how to write to a local path.

Hand-rolled

Three files are all Obsidian needs — manifest.json, main.js, versions.json. Drop them in <vault>/.obsidian/plugins/beaver/ however you like (unzip, scp, rsync, your own git, …).

Bumping the version

Edit the version field in manifest.json, package.json, and versions.json by hand. Three files, one change each.

2.4 KiB Raw Blame History