notebridge

Multi-platform note bridge — translate notes between any reading platform and any knowledge base.

weread → IR → getnote
flomo  → IR → obsidian
local  → IR → notion

Install

npm install -g @chucan1013/notebridge

Quick Start

# Set credentials
export WEREAD_API_KEY=wrk-xxx
export GETNOTE_API_KEY=gk_xxx

# Flomo: authenticate once
notebridge flomo auth

# Transfer highlights from WeRead to GetNote
notebridge weread --book "三体" --to getnote

# Dry-run: preview without writing
notebridge weread --book "三体" --to getnote --dry-run

# Transfer to Obsidian vault
notebridge weread --book "三体" --to obsidian

# List available platforms
notebridge --list-sources
notebridge --list-targets

Supported Platforms

Sources

• weread — WeChat Read highlights and thoughts
• flomo — Flomo memos (auth once: notebridge flomo auth)
• notion — Notion pages (auth: NOTION_API_KEY=ntn_xxx)
• obsidian — Obsidian vault (wikilinks, YAML tags, frontmatter)
• local-markdown — Local .md files with frontmatter

Destinations

• getnote — GetNote (Get 笔记)
• flomo — Flomo (via webhook)
• notion — Notion pages (auth: NOTION_API_KEY=ntn_xxx)
• obsidian — Obsidian vault (.md files with frontmatter)

How It Works

notebridge uses a universal intermediate representation (IR) to translate notes between platforms:

[Source] → SourceAdapter → NoteIR[] → DestinationAdapter → [Target]

Each platform only needs two adapters (read + write). Add a new platform and it works with all existing platforms — no combinatorial bridge explosion.

Write Your Own Adapter

import { registerSource, SourceAdapter } from "@chucan1013/notebridge";

const myReader: SourceAdapter = {
  platform: "my-app",
  version: "0.1.0",
  async healthCheck(config) { /* ... */ },
  async listResources(config) { /* ... */ },
  async fetch(resource, config) { /* return NoteIR[] */ },
};

registerSource(myReader);

See src/adapters/interfaces.ts for the full interface.

Claude Code Skill

There's a companion skill that wraps notebridge for Claude Code:

claude skills add chucan1/weread-to-getnote

Changelog

| Version | Date | Changes | |---------|------|---------| | 0.1.3 | 2026-05-29 | flomo-reader adapter + notebridge flomo auth one-time setup | | 0.1.2 | 2026-05-29 | --list-resources, -o json output, skill v3.0.0 | | 0.1.1 | 2026-05-29 | Positional arg support (notebridge weread without --source) | | 0.1.0 | 2026-05-29 | Initial release: weread-reader, getnote-writer, obsidian-writer, local-markdown-reader, PipelineRunner, CLI |

License

MIT