Local-first tools for Confluence

Confluence Toolbelt

Confluence pages, edited locally, with Markdown and AI in the loop.

A command-line tool and Obsidian plugin for downloading, editing, merging and uploading Confluence pages without losing comments or mentions.

Visit the project View on GitHub

Inside the application

See it in action.

The workflow turns a Confluence page into local Markdown, keeps its collaboration context and publishes the edited result back to Confluence.

Confluence Toolbelt uploading an edited Markdown page

Why it exists

Write where ideas move faster.

Confluence Toolbelt turns pages into local Markdown so they can be edited with Cursor, another AI agent, a text editor or Obsidian. It translates the result back into Confluence storage format and preserves the collaborative context around the page.

Its experimental sync workflow performs a three-way merge between local changes, new remote edits and the last known base. Conflicts stay visible and detached comments are preserved rather than silently discarded.

What it does

Confluence content, without the Confluence editor.

Keep the collaboration that belongs in Confluence while using Markdown, Obsidian and AI-capable editors for the work itself.

Download, search, edit and upload Confluence pages as Markdown from the CLI or Obsidian

Preserve inline comments, mentions, status labels, attachments and page metadata

Three-way sync local and remote edits, expose conflicts and retain detached comments instead of losing them

Use the Obsidian plugin on desktop and mobile, with native properties, callouts, links and embeds

Create sibling or child pages from local Markdown and create preconfigured Jira tasks from the terminal

Open source, ready to explore

Take a Confluence page into your own writing workflow.

Read the README and get started

Under the hood

Built with

TypeScriptNode.jsObsidianConfluence API

Build approach: Vibe-coded → AI-engineered
The project began as vibe coding around a concrete workflow problem. As it matured, I moved into AI-engineering: directing architecture, merge behavior, mobile constraints and testing in technical terms while agents handled most implementation work.
AI tools and models
Claude Opus 4.5 and 4.6
Availability: Published npm package · Obsidian plugin in progress
License: MIT
Source: GitHub repository