@andrzejchm/notion-cli 0.9.0 → 0.9.1

package/docs/FEATURE-PARITY.md

@@ -4,7 +4,7 @@
 > This document tracks gaps and serves as a prioritized roadmap for closing them.
 
 **Legend:**
-- **CLI** = `@andrzejchm/notion-cli` (this repo, v0.8.0)
+- **CLI** = `@andrzejchm/notion-cli` (this repo, v0.9.0)
 - **MCP** = Official Notion MCP server
 
 ---
@@ -16,12 +16,12 @@
 | Search | Keyword + sort by last edited | Semantic + AI + connected sources + date/creator filters | Partial |
 | Page read | Markdown via API | Markdown + discussions + transcripts | Partial |
 | Page create | Under pages only | Under pages, databases, data sources; batch; templates; icon/cover | Partial |
-| Page edit | Surgical replace via `--range` | Search-and-replace (multi-op), full replace, template apply, verification | Partial |
+| Page edit | Multi-op `--find`/`--replace`, `--range` | Search-and-replace (multi-op), full replace, template apply, verification | Partial |
 | Page properties | Read + write via `update --prop` | Full read + write (update any property) | ✅ Parity |
 | Move pages | - | Batch move to any parent | Gap |
 | Duplicate pages | - | Duplicate with async content copy | Gap |
 | Archive/delete | `archive` | Trash pages | ✅ Parity |
-| Database create | - | SQL DDL `CREATE TABLE` syntax | Gap |
+| Database create | `db create --prop` syntax | SQL DDL `CREATE TABLE` syntax | Partial |
 | Database schema update | Read-only schema | `ADD/DROP/RENAME/ALTER COLUMN` via DDL | Gap |
 | Database views | - | Create + update 10 view types with DSL | Gap |
 | Comments | Page-level + block-level + thread replies, list with discussion IDs | Page-level + inline (selection-anchored) + reply to thread + rich text | Partial |
@@ -69,11 +69,10 @@ These gaps directly limit what an AI agent can accomplish through the CLI compar
 **CLI:** Thread replies (`--reply-to <discussion-id>`) and block-level comments (`--block <block-id>`) shipped. Discussion IDs shown in `notion comments` list output. Inline text-selection anchoring is not available in the public API. Plain text only.
 **Remaining gap:** Rich text (mentions, dates, links) and inline text-selection anchoring (`selection_with_ellipsis`) — the latter requires internal API access.
 
-#### 6. Create databases
+#### 6. ✅ Create databases (shipped v0.10.0)
 **MCP:** `CREATE TABLE` DDL with full type system (select, relation, rollup, formula, unique_id, etc.).
-**CLI:** No equivalent.
-**Why:** Agents building project scaffolds or workflows need to create structured databases, not just pages.
-**Suggested command:** `notion create-db --parent <id> --title "Tasks" --schema "Name TITLE, Status SELECT(Todo,Done)"`
+**CLI:** `notion db create --parent <id> --title "Tasks" --prop "Status:select:To Do,Done"` — supports title, rich_text, number, select, multi_select, status, date, checkbox, url, email, phone_number, people, files, created_time, last_edited_time. Relation, rollup, formula, and unique_id are not supported (too complex for CLI flags).
+**Status:** Shipped in v0.10.0.
 
 #### 7. Move pages
 **MCP:** Batch move up to 100 pages/databases to a new parent (page, database, data source, or workspace).
@@ -87,11 +86,10 @@ These gaps directly limit what an AI agent can accomplish through the CLI compar
 **Why:** Evolving database structure (adding a new status option, renaming a field) without leaving the terminal.
 **Suggested command:** `notion db alter <id> --add "Priority SELECT(High,Medium,Low)" --rename "Status:Project Status"`
 
-#### 9. Multi-operation content editing
+#### 9. ✅ Multi-operation content editing (shipped v0.9.0)
 **MCP:** `update_content` accepts an array of `{ old_str, new_str }` pairs (up to 100) in a single call, with `replace_all_matches` option.
-**CLI:** `notion edit-page` supports single `--range` replacement. No batch search-and-replace.
-**Why:** Agents making multiple edits to a page (updating several sections) currently need multiple CLI invocations.
-**Suggested approach:** Support multiple `--replace "old...new"` flags or a JSON patch file.
+**CLI:** `notion edit-page` supports multiple `--find`/`--replace` pairs in a single invocation (PR #6).
+**Status:** Shipped in v0.9.0.
 
 #### 10. Duplicate pages
 **MCP:** `duplicate-page` — async copy of any accessible page.
@@ -180,6 +178,6 @@ The CLI isn't just chasing MCP parity — it has unique strengths:
 
 ---
 
-*Last updated: 2026-03-23*
-*CLI version compared: 0.8.0*
+*Last updated: 2026-03-24*
+*CLI version compared: 0.9.0*
 *MCP version compared: Official Notion MCP (2026-03)*

package/docs/README.agents.md

@@ -1,10 +1,10 @@
-# notion-cli for OpenCode
+# notion-cli for AI Coding Agents
 
-Complete guide for using notion-cli with [OpenCode](https://opencode.ai).
+Complete guide for using notion-cli with AI coding agents (Claude Code, OpenCode, Cursor, Windsurf, etc.).
 
 ## Quick Install
 
-Tell OpenCode:
+Tell your AI agent:
 
 ```
 Fetch and follow instructions from https://raw.githubusercontent.com/andrzejchm/notion-cli/main/docs/README.agents.md
@@ -24,14 +24,17 @@ npm install -g @andrzejchm/notion-cli
 
 Homebrew bundles Node.js automatically. npm requires Node.js ≥ 22.
 
-### 2. Install the skill file
+### 2. Install the skill
 
-```bash
-mkdir -p ~/.config/opencode/skills/using-notion-cli
-curl -fsSL https://raw.githubusercontent.com/andrzejchm/notion-cli/main/docs/skills/using-notion-cli/SKILL.md \
-  -o ~/.config/opencode/skills/using-notion-cli/SKILL.md
+The skill file teaches your AI agent how to use notion-cli. It follows the open [Agent Skills](https://agentskills.io) standard.
+
+**Skill URL:**
+```
+https://raw.githubusercontent.com/andrzejchm/notion-cli/main/docs/skills/using-notion-cli/SKILL.md
 ```
 
+**Agent:** Ask the user whether they want the skill installed **globally** (all projects) or **per-project**, then consult your own documentation for the correct skill install path. The skill directory name must be `using-notion-cli` and the file must be named `SKILL.md`.
+
 ### 3. Authenticate
 
 **Interactive setup** (choose OAuth or integration token):
@@ -63,7 +66,7 @@ notion --version   # CLI installed
 notion ls          # auth works
 ```
 
-Restart OpenCode after installing. The skill is now discoverable via the `skill` tool.
+Restart your agent session after installing so it picks up the new skill.
 
 ## Updating
 
@@ -73,12 +76,10 @@ brew upgrade notion-cli
 
 # npm
 npm install -g @andrzejchm/notion-cli
-
-# Update skill file (either install method)
-curl -fsSL https://raw.githubusercontent.com/andrzejchm/notion-cli/main/docs/skills/using-notion-cli/SKILL.md \
-  -o ~/.config/opencode/skills/using-notion-cli/SKILL.md
 ```
 
+To update the skill file, re-download it from the URL in step 2 to the same location.
+
 ## Commands Reference
 
 ### `notion search <query>` / `notion ls`

package/docs/skills/using-notion-cli/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: using-notion-cli
 description: Reads and writes Notion pages using the `notion` CLI tool. Use when accessing Notion content, searching workspace pages, querying database entries, reading page markdown, appending content, creating pages, or adding comments from the terminal or within automated workflows.
-license: MIT
-compatibility: opencode
 ---
 
 ## Setup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrzejchm/notion-cli",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Read Notion pages and databases from the terminal. Built for AI agents and developers.",
   "keywords": [
     "notion",