AlgoForge for Obsidian

Edit AlgoForge .af files visually inside Obsidian and embed them in notes.

Usage

Use AlgoForge: New algorithm, right-click a vault file or folder and choose New Algorithm to create the next available algorithm.af name immediately, or open an existing .af/.algoforge file. Embed an algorithm with:

![[algorithms/example.af]]

Embeds render as full-width, read-only previews in Reading view and Live Preview, using the active Obsidian theme palette. Click a preview to open the source algorithm. Move the cursor into a Live Preview embed to reveal its Markdown source.

Installation and development

Download main.js, manifest.json, and styles.css from the latest release into .obsidian/plugins/algoforge/, then enable AlgoForge under Community plugins. You can also install the release repository with BRAT.

This repository is an automated release mirror. The canonical source and development history live in Bing-Chill-inc/Algoforge-main. Each release tag also contains a read-only snapshot of the Obsidian plugin and shared document protocol under src/. The sandboxed web editor's source is under docs/embedded-editor/: it uses browser APIs within its isolated iframe, not Obsidian's plugin APIs. The mirror is not an independent development checkout. From a checkout of that monorepo:

cd src/obsidian-plugin
bun install
bun run check

The release has only Obsidian's three installation assets. Their provenance can be checked with gh attestation verify main.js -R Bing-Chill-inc/algoforge-obsidian (and likewise for manifest.json and styles.css). The mirror workflow also verifies the canonical build attestation from Bing-Chill-inc/Algoforge-main before publishing.

Privacy and limitations

The plugin is desktop-only, works entirely from local vault files, and performs no authentication, telemetry, or network requests. AlgoForge Cloud and interactive editing inside note embeds are not supported. Obsidian Publish and external Markdown renderers do not run the plugin; export SVG or PNG for a portable image.

The Open Algorithm and Import pickers enumerate vault file paths locally to show eligible files; they do not upload paths or file contents. Clipboard access is used only for explicit copy/paste actions in the visual editor.