jackwener__opencli/docs/index.md at main

mirror of https://github.com/jackwener/OpenCLI.git synced 2026-09-14 18:25:42 +08:00

Files

T

jakevin 29c135b656 refactor(notion): replace built-in CDP adapter with external ntn CLI (#1559 )

* refactor(notion): replace built-in CDP adapter with external ntn CLI

Notion has shipped an official CLI at https://ntn.dev. It uses the
public Notion API (blocks / databases / properties / comments) instead
of reverse-engineering the Desktop UI, so it survives Notion app
updates and exposes a wider command surface than the in-tree adapter
could.

Changes:
  - `src/external-clis.yaml` — register `ntn` as first-class external CLI
    (binary `ntn`, homepage ntn.dev, install via the shell-pipe script
    on mac/linux)
  - `clis/notion/` — entire directory removed (8 commands: status /
    search / read / new / write / sidebar / favorites / export)
  - `docs/adapters/desktop/notion.md` — removed
  - `docs/.vitepress/config.mts` — drop nav entry
  - `docs/adapters/index.md` — drop adapter row
  - `README.md` / `README.zh-CN.md` — drop notion from feature lines,
    drop adapter table row, add `ntn` to CLI hub examples
  - `docs/index.md` / `docs/zh/index.md` / `docs/guide/getting-started.md`
    — drop notion from electron-control feature copy
  - `skills/opencli-usage/SKILL.md` — drop notion from electron list
  - `cli-manifest.json` — rebuilt with --allow-removals=8

Migration for users:
  `curl -fsSL https://ntn.dev | bash`  (or `opencli external install ntn`)
  Then use `opencli ntn <command>` in place of `opencli notion <command>`.

Rationale: the in-tree adapter was reverse-engineered against Notion
Desktop CDP and shipped only 8 commands. The official CLI gives users
the full Notion API surface and reduces our maintenance burden to zero.
Same pattern as gh / obsidian / lark-cli / tg-cli / discord-cli / wx-cli.

Verification:
  - `npx tsc --noEmit` clean
  - `npx vitest run --project unit` → 1091/1 skipped
  - `npm run build` (with --allow-removals=8) — manifest 809 entries
  - grep notion in user-facing docs (README / docs / skills) — only
    descriptive mentions remain in non-blocking places (comparison /
    site-recon / electron how-to / design doc), no broken adapter
    references

* fix(notion): align ntn external migration

* docs(notion): clarify ntn manual install

2026-05-14 16:12:17 +08:00

1.3 KiB

Raw Permalink Blame History

layout, hero, features

layout

hero

features

home

name

text

tagline

actions

OpenCLI

Make any website or Electron App your CLI

Zero risk · Reuse Chrome login · AI-powered discovery · Browser + Desktop automation

theme	text	link
brand	Get Started	/guide/getting-started

theme	text	link
alt	View on GitHub	https://github.com/jackwener/opencli

icon	title	details
🖥️	Desktop App Control	Drive Electron apps (Cursor, Codex, ChatGPT, etc.) directly from the terminal via CDP.

icon	title	details
🌐	Browser Automation	AI agents get direct browser control: click, type/fill, extract, screenshot — any interaction, fully scriptable.

icon	title	details
🔐	Account Safe	Reuses Chrome's logged-in state. Your credentials never leave the browser — no tokens, no exposed passwords.

icon	title	details
🤖	AI Agent Ready	Browser primitives plus adapter-authoring skills give AI agents a repeatable loop for recon, extraction, verification, and adapter writing.

icon	title	details
💰	Zero LLM Cost	No tokens consumed at runtime. Run 10,000 times and pay nothing.

icon	title	details
🔁	Deterministic	Same command, same output schema, every time. Pipeable, scriptable, CI-friendly.

1.3 KiB Raw Permalink Blame History

1.3 KiB

Raw Permalink Blame History