@tk_wfl/o2n-cli

CLI for o2n — migrates an Obsidian vault into a Notion workspace while preserving folder structure, note-to-note links (wikilinks), frontmatter, and attachments.

• Repository / full docs: https://github.com/TK-WFL/o2n
• License: MIT

Install

npx @tk_wfl/o2n-cli scan <vaultPath>
# or
npm install -g @tk_wfl/o2n-cli

Requires Node.js 20+.

Connect to Notion

export NOTION_TOKEN=ntn_xxx

Simplest: a personal access token from Notion's developer portal (Personal access tokens → New token). It writes with your own permissions, so no per-page connect step is needed. If you use an internal integration token instead, the destination parent page must already be connected to that integration in Notion (page → ... menu → Connections).

Commands

npx @tk_wfl/o2n-cli scan <vaultPath>
npx @tk_wfl/o2n-cli plan <vaultPath> --parent <NotionPageId>   # --embed-mode inline expands ![[note]] embeds in place
npx @tk_wfl/o2n-cli migrate <vaultPath> --plan <vaultPath>/.o2n/plan.json --dry-run
npx @tk_wfl/o2n-cli migrate <vaultPath> --plan <vaultPath>/.o2n/plan.json
npx @tk_wfl/o2n-cli resume <vaultPath>
npx @tk_wfl/o2n-cli verify <vaultPath>          # add --deep to compare against the real Notion pages
npx @tk_wfl/o2n-cli report <vaultPath>

Exit codes: 0 = fully succeeded, 1 = some notes failed, 2 = fatal error.

See the main README for the full command reference, what gets converted, and the security model.