[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75FAE4BCCXM3W6GAZ0807Q7":3,"skill-same:01M75FAE4BCCXM3W6GAZ0807Q7":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":40,"ownerDescription":41,"updatedAt":42,"install":43,"resources":56},"01M75FAE4BCCXM3W6GAZ0807Q7","vibe-notion",null,"Interact with Notion using the unofficial private API - pages, databases, blocks, search, users, comments","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fdevxoul\u002Fvibe-notion\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: vibe-notion\ndescription: Interact with Notion using the unofficial private API - pages, databases, blocks, search, users, comments\nversion: 1.2.2\nallowed-tools: Bash(vibe-notion:*)\nmetadata:\n  openclaw:\n    requires:\n      bins:\n        - vibe-notion\n    install:\n      - kind: node\n        package: vibe-notion\n        bins: [vibe-notion]\n---\n\n# Vibe Notion\n\nA TypeScript CLI tool that enables AI agents and humans to interact with Notion workspaces through the unofficial private API. Supports full CRUD operations on pages, databases, blocks, search, and user management.\n\n> **Note**: This skill uses Notion's internal\u002Fprivate API (`\u002Fapi\u002Fv3\u002F`), which is separate from the official public API. For official API access, use `vibe-notionbot`.\n\n\n## Which CLI to Use\n\nThis package ships two CLIs. Pick the right one based on your situation:\n\n| | `vibe-notion` (this CLI) | `vibe-notionbot` |\n|---|---|---|\n| API | Unofficial private API | Official Notion API |\n| Auth | `token_v2` auto-extracted from Notion desktop app | `NOTION_TOKEN` env var (Integration token) |\n| Identity | Acts as the user | Acts as a bot |\n| Setup | Zero — credentials extracted automatically | Manual — create Integration at notion.so\u002Fmy-integrations |\n| Database rows | `add-row`, `update-row` | Create via `page create --database` |\n| View management | `view-get`, `view-update`, `view-list`, `view-add`, `view-delete` | Not supported |\n| Workspace listing | Supported | Not supported |\n| Stability | Private API — may break on Notion changes | Official versioned API — stable |\n\n**Decision flow:**\n\n1. If the Notion desktop app is installed → use `vibe-notion` (this CLI)\n2. If `NOTION_TOKEN` is set but no desktop app → use `vibe-notionbot`\n3. If both are available → prefer `vibe-notion` (broader capabilities, zero setup)\n4. If neither → ask the user to set up one of the two\n\n## Important: CLI Only\n\n**Never call Notion's internal API directly.** Always use the `vibe-notion` CLI commands described in this skill. Do not make raw HTTP requests to `notion.so\u002Fapi\u002Fv3\u002F` or use any Notion client library. Direct API calls risk exposing credentials and may trigger Notion's abuse detection, getting the user's account blocked.\n\nIf a feature you need is not supported by `vibe-notion`, let the user know and offer to file a feature request at [devxoul\u002Fvibe-notion](https:\u002F\u002Fgithub.com\u002Fdevxoul\u002Fvibe-notion\u002Fissues) on their behalf. Before submitting, strip out any real user data — IDs, names, emails, tokens, page content, or anything else that could identify the user or their workspace. Use generic placeholders instead and keep the issue focused on describing the missing capability.\n\n## Important: Never Write Scripts\n\n**Never write scripts (Python, TypeScript, Bash, etc.) to automate Notion operations.** The `batch` command already handles bulk operations of any size. Writing a script to loop through API calls is always wrong — use `batch` with `--file` instead.\n\nThis applies even when:\n- You need to create 100+ rows\n- You need cross-references between newly created rows (use multi-pass batch — see [references\u002Fbatch-operations.md](references\u002Fbatch-operations.md#bulk-operations-strategy))\n- The operation feels \"too big\" for a single command\n\nIf you catch yourself thinking \"I should write a script for this,\" stop and use `batch`.\n\n## Quick Start\n\n```bash\n# 1. Find your workspace ID\nvibe-notion workspace list --pretty\n\n# 2. Search for a page\nvibe-notion search \"Roadmap\" --workspace-id \u003Cworkspace-id> --pretty\n\n# 3. Get page content\nvibe-notion page get \u003Cpage-id> --workspace-id \u003Cworkspace-id> --pretty\n\n# 4. Query a database\nvibe-notion database query \u003Ccollection-id> --workspace-id \u003Cworkspace-id> --pretty\n```\n\nCredentials are auto-extracted from the Notion desktop app on first use. No manual setup needed.\n\n> **Important**: `--workspace-id` is required for ALL commands that operate within a specific workspace. Use `vibe-notion workspace list` to find your workspace ID.\n\n## Authentication\n\nCredentials (`token_v2`) are auto-extracted from the Notion desktop app when you run any command. No API keys, OAuth, or manual extraction needed.\n\nOn macOS, your system may prompt for Keychain access on first use — this is normal and required to decrypt the cookie.\n\nThe extracted `token_v2` is stored at `~\u002F.config\u002Fvibe-notion\u002Fcredentials.json` with `0600` permissions.\n\n## Memory\n\nThe agent maintains a `~\u002F.config\u002Fvibe-notion\u002FMEMORY.md` file as persistent memory across sessions. This is agent-managed — the CLI does not read or write this file. Use the `Read` and `Write` tools to manage your memory file.\n\n### Reading Memory\n\nAt the **start of every task**, read `~\u002F.config\u002Fvibe-notion\u002FMEMORY.md` using the `Read` tool to load any previously discovered workspace IDs, page IDs, database IDs, and user preferences.\n\n- If the file doesn't exist yet, that's fine — proceed without it and create it when you first have useful information to store.\n- If the file can't be read (permissions, missing directory), proceed without memory — don't error out.\n\n### Writing Memory\n\nAfter discovering useful information, update `~\u002F.config\u002Fvibe-notion\u002FMEMORY.md` using the `Write` tool. Write triggers include:\n\n- After discovering workspace IDs (from `workspace list`)\n- After discovering useful page IDs, database IDs, collection IDs (from `search`, `page list`, `page get`, `database list`, etc.)\n- After the user gives you an alias or preference (\"call this the Tasks DB\", \"my main workspace is X\")\n- After discovering page\u002Fdatabase structure (parent-child relationships, what databases live under which pages)\n\nWhen writing, include the **complete file content** — the `Write` tool overwrites the entire file.\n\n### What to Store\n\n- Workspace IDs with names\n- Page IDs with titles and parent context\n- Database\u002Fcollection IDs with titles and parent context\n- User-given aliases (\"Tasks DB\", \"Main workspace\")\n- Commonly used view IDs\n- Parent-child relationships (which databases are under which pages)\n- Any user preference expressed during interaction\n\n### What NOT to Store\n\nNever store `token_v2`, credentials, API keys, or any sensitive data. Never store full page content (just IDs and titles). Never store block-level IDs unless they're persistent references (like database blocks).\n\n### Handling Stale Data\n\nIf a memorized ID returns an error (page not found, access denied), remove it from `MEMORY.md`. Don't blindly trust memorized data — verify when something seems off. Prefer re-searching over using a memorized ID that might be stale.\n\n### Format \u002F Example\n\nHere's a concrete example of how to structure your `MEMORY.md`:\n\n```markdown\n# Vibe Notion Memory\n\n## Workspaces\n\n- `abc123-...` — Acme Corp (default)\n\n## Pages (Acme Corp)\n\n- `page-id-1` — Product Roadmap (top-level)\n- `page-id-2` — Q1 Planning (under Product Roadmap)\n\n## Databases (Acme Corp)\n\n- `coll-id-1` — Tasks (under Product Roadmap, views: `view-1`)\n- `coll-id-2` — Contacts (top-level)\n\n## Aliases\n\n- \"roadmap\" → `page-id-1` (Product Roadmap)\n- \"tasks\" → `coll-id-1` (Tasks database)\n\n## Notes\n\n- User prefers --pretty output for search results\n- Main workspace is \"Acme Corp\"\n```\n\n> Memory lets you skip repeated `search` and `workspace list` calls. When you already know an ID from a previous session, use it directly.\n\n## Commands\n\n### Auth Commands\n\n```bash\nvibe-notion auth status     # Check authentication status\nvibe-notion auth logout     # Remove stored token_v2\nvibe-notion auth extract    # Manually re-extract token_v2 (for troubleshooting)\n```\n\n### Page Commands\n\n```bash\n# List pages in a space (top-level only)\nvibe-notion page list --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion page list --workspace-id \u003Cworkspace_id> --depth 2 --pretty\n\n# Get a page and all its content blocks\nvibe-notion page get \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion page get \u003Cpage_id> --workspace-id \u003Cworkspace_id> --limit 50\nvibe-notion page get \u003Cpage_id> --workspace-id \u003Cworkspace_id> --backlinks --pretty\n\n# Create a new page (--parent is optional; omit to create at workspace root)\nvibe-notion page create --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --title \"My Page\" --pretty\nvibe-notion page create --workspace-id \u003Cworkspace_id> --title \"New Root Page\" --pretty\n\n\n# Create a page with markdown content\nvibe-notion page create --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --title \"My Doc\" --markdown '# Hello\\n\\nThis is **bold** text.'\n\n# Create a page with markdown from a file\nvibe-notion page create --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --title \"My Doc\" --markdown-file .\u002Fcontent.md\n\n# Create a page with markdown containing local images (auto-uploaded to Notion)\nvibe-notion page create --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --title \"My Doc\" --markdown-file .\u002Fdoc-with-images.md\n\n# Replace all content on a page with new markdown\nvibe-notion page update \u003Cpage_id> --workspace-id \u003Cworkspace_id> --replace-content --markdown '# New Content'\nvibe-notion page update \u003Cpage_id> --workspace-id \u003Cworkspace_id> --replace-content --markdown-file .\u002Fupdated.md\n\n# Update page title or icon\nvibe-notion page update \u003Cpage_id> --workspace-id \u003Cworkspace_id> --title \"New Title\" --pretty\nvibe-notion page update \u003Cpage_id> --workspace-id \u003Cworkspace_id> --icon \"🚀\" --pretty\n\n# Archive a page\nvibe-notion page archive \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Get page or database row properties (without content blocks — lightweight alternative to page get)\nvibe-notion page properties \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\n```\n\n### Database Commands\n\n```bash\n# Get database schema\nvibe-notion database get \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Query a database (auto-resolves default view)\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --limit 10 --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --view-id \u003Cview_id> --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --search-query \"keyword\" --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --timezone \"America\u002FNew_York\" --pretty\n\n# Query with filter and sort (uses property IDs from database get schema)\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --filter '\u003Cfilter_json>' --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --sort '\u003Csort_json>' --pretty\n\n# List all databases in workspace\nvibe-notion database list --workspace-id \u003Cworkspace_id> --pretty\n\n# Create a database\nvibe-notion database create --workspace-id \u003Cworkspace_id> --parent \u003Cpage_id> --title \"Tasks\" --pretty\nvibe-notion database create --workspace-id \u003Cworkspace_id> --parent \u003Cpage_id> --title \"Tasks\" --properties '{\"status\":{\"name\":\"Status\",\"type\":\"select\"}}' --pretty\n\n# Update database title or schema\nvibe-notion database update \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"New Name\" --pretty\nvibe-notion database update \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --properties '{\"status\":{\"name\":\"Status\",\"type\":\"select\"}}' --pretty\nvibe-notion database update \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"New Name\" --properties '{\"status\":{\"name\":\"Status\",\"type\":\"select\"}}' --pretty\n\n# Add a row to a database\nvibe-notion database add-row \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"Row title\" --pretty\nvibe-notion database add-row \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"Row title\" --properties '{\"Status\":\"In Progress\",\"Due\":{\"start\":\"2025-03-01\"}}' --pretty\n\n# Add row with date range\nvibe-notion database add-row \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"Event\" --properties '{\"Due\":{\"start\":\"2026-01-01\",\"end\":\"2026-01-15\"}}' --pretty\n\n# Update properties on an existing database row (row_id from database query)\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Status\":\"Done\"}' --pretty\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Priority\":\"High\",\"Tags\":[\"backend\",\"infra\"]}' --pretty\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Due\":{\"start\":\"2026-06-01\"},\"Status\":\"In Progress\"}' --pretty\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Due\":{\"start\":\"2026-01-01\",\"end\":\"2026-01-15\"}}' --pretty\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Related\":[\"\u003Ctarget_row_id>\"]}' --pretty\n\n# Delete a property from a database (cannot delete the title property)\nvibe-notion database delete-property \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --property \"Status\" --pretty\n\n# Get view configuration and property visibility\nvibe-notion database view-get \u003Cview_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Show or hide properties on a view (comma-separated names)\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --show \"ID,Due\" --pretty\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --hide \"Assignee\" --pretty\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --show \"Status\" --hide \"Due\" --pretty\n\n# Reorder columns (comma-separated names in desired order; unmentioned columns appended)\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --reorder \"Name,Status,Priority,Date\" --pretty\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --reorder \"Name,Status\" --show \"Status\" --pretty\n\n# Resize columns (JSON mapping property names to pixel widths)\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --resize '{\"Name\":200,\"Status\":150}' --pretty\n\n# List all views for a database\nvibe-notion database view-list \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Add a new view to a database (default type: table)\nvibe-notion database view-add \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion database view-add \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --type board --name \"Board View\" --pretty\n\n# Delete a view from a database (cannot delete the last view)\nvibe-notion database view-delete \u003Cview_id> --workspace-id \u003Cworkspace_id> --pretty\n```\n\n### Block Commands\n\n```bash\n# Get a specific block\nvibe-notion block get \u003Cblock_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion block get \u003Cblock_id> --workspace-id \u003Cworkspace_id> --backlinks --pretty\n\n# List child blocks\nvibe-notion block children \u003Cblock_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion block children \u003Cblock_id> --workspace-id \u003Cworkspace_id> --limit 50 --pretty\nvibe-notion block children \u003Cblock_id> --workspace-id \u003Cworkspace_id> --start-cursor '\u003Cnext_cursor_json>' --pretty\n\n# Append child blocks\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --content '[{\"type\":\"text\",\"properties\":{\"title\":[[\"Hello world\"]]}}]' --pretty\n\n# Append markdown content as blocks\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --markdown '# Hello\\n\\nThis is **bold** text.'\n\n# Append markdown from a file\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --markdown-file .\u002Fcontent.md\n\n# Append markdown with local images (auto-uploaded to Notion)\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --markdown-file .\u002Fdoc-with-images.md\n\n# Append nested markdown (indented lists become nested children blocks)\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --markdown '- Parent item\\n  - Child item\\n    - Grandchild item'\n\n# Append blocks after a specific block (positional insertion)\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --after \u003Cblock_id> --markdown '# Inserted after specific block'\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --after \u003Cblock_id> --content '[{\"type\":\"text\",\"properties\":{\"title\":[[\"Inserted after\"]]}}]'\n\n# Append blocks before a specific block\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --before \u003Cblock_id> --markdown '# Inserted before specific block'\n\n# Update a block\nvibe-notion block update \u003Cblock_id> --workspace-id \u003Cworkspace_id> --content '{\"properties\":{\"title\":[[\"Updated text\"]]}}' --pretty\n\n# Delete a block\nvibe-notion block delete \u003Cblock_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Upload a file as a block (image or file block)\nvibe-notion block upload \u003Cparent_id> --workspace-id \u003Cworkspace_id> --file .\u002Fimage.png --pretty\nvibe-notion block upload \u003Cparent_id> --workspace-id \u003Cworkspace_id> --file .\u002Fdocument.pdf --pretty\nvibe-notion block upload \u003Cparent_id> --workspace-id \u003Cworkspace_id> --file .\u002Fimage.png --after \u003Cblock_id> --pretty\nvibe-notion block upload \u003Cparent_id> --workspace-id \u003Cworkspace_id> --file .\u002Fimage.png --before \u003Cblock_id> --pretty\n\n# Move a block to a new position\nvibe-notion block move \u003Cblock_id> --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --pretty\nvibe-notion block move \u003Cblock_id> --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --after \u003Csibling_id> --pretty\nvibe-notion block move \u003Cblock_id> --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --before \u003Csibling_id> --pretty\n```\n\n### Block Types & Rich Text Reference\n\nFor block type JSON format (headings, text, lists, to-do, code, quote, divider) and rich text formatting codes, see [references\u002Fblock-types.md](references\u002Fblock-types.md).\n\n### Comment Commands\n\n```bash\n# List comments on a page\nvibe-notion comment list --page \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# List inline comments on a specific block\nvibe-notion comment list --page \u003Cpage_id> --block \u003Cblock_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Create a comment on a page (starts a new discussion)\nvibe-notion comment create \"This is a comment\" --page \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Reply to an existing discussion thread\nvibe-notion comment create \"Replying to thread\" --discussion \u003Cdiscussion_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Get a specific comment by ID\nvibe-notion comment get \u003Ccomment_id> --workspace-id \u003Cworkspace_id> --pretty\n```\n\n## Batch Operations\n\nFor batch command format, supported actions (14 total), operation JSON structure, output format, fail-fast behavior, bulk operations strategy (multi-pass pattern), and rate limit handling, see [references\u002Fbatch-operations.md](references\u002Fbatch-operations.md).\n\n**Quick usage:**\n\n```bash\n# Inline JSON\nvibe-notion batch --workspace-id \u003Cworkspace_id> '\u003Coperations_json>'\n\n# From file (for large payloads)\nvibe-notion batch --workspace-id \u003Cworkspace_id> --file .\u002Foperations.json '[]'\n```\n\n### Search Command\n\n```bash\n# Search across workspace (--workspace-id is required)\nvibe-notion search \"query\" --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion search \"query\" --workspace-id \u003Cworkspace_id> --limit 10 --pretty\nvibe-notion search \"query\" --workspace-id \u003Cworkspace_id> --start-cursor \u003Coffset> --pretty\nvibe-notion search \"query\" --workspace-id \u003Cworkspace_id> --sort lastEdited --pretty\n```\n\n### User Commands\n\n```bash\n# Get current user info\nvibe-notion user me --pretty\n\n# Get a specific user\nvibe-notion user get \u003Cuser_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# List users in a workspace\nvibe-notion user list --workspace-id \u003Cworkspace_id> --pretty\n```\n\n## Output Format\n\nAll commands output JSON by default. Use `--pretty` for human-readable output.\n\nFor JSON response shapes (search, database query, page get, block get, backlinks), `$hints` schema warnings, and detailed examples, see [references\u002Foutput-format.md](references\u002Foutput-format.md).\n\n## When to Use `--backlinks`\n\nBacklinks reveal which pages\u002Fdatabases **link to** a given page. This is critical for efficient navigation.\n\n**Use `--backlinks` when:**\n- **Tracing relations**: A search result looks like a select option, enum value, or relation target (e.g., a plan name or category). Backlinks instantly reveal all rows\u002Fpages that reference it via relation properties — no need to hunt for the parent database.\n- **Finding references**: You found a page and want to know what other pages mention or link to it.\n- **Reverse lookups**: Instead of querying every database to find rows pointing to a page, use backlinks on the target page to get them directly.\n\n**Example — finding who uses a specific plan:**\n```bash\n# BAD: 15 API calls — search, open empty pages, trace parents, find database, query\nvibe-notion search \"Enterprise Plan\" ...\nvibe-notion page get \u003Cplan-page-id> ...  # empty\nvibe-notion block get \u003Cplan-page-id> ...  # find parent\n# ... many more calls to discover the database\n\n# GOOD: 2-3 API calls — search, then backlinks on the target\nvibe-notion search \"Enterprise Plan\" ...\nvibe-notion page get \u003Cplan-page-id> --backlinks --pretty\n# → backlinks immediately show all people\u002Frows linked to this plan\n```\n\n## Pagination\n\nCommands that return lists support pagination via `has_more`, `next_cursor` fields:\n\n- **`block children`**: Cursor-based. Pass `next_cursor` value from previous response as `--start-cursor`.\n- **`search`**: Offset-based. Pass `next_cursor` value (a number) as `--start-cursor`.\n- **`database query`**: Use `--limit` to control page size. `has_more` indicates more results exist, but the private API does not support cursor-based pagination — increase `--limit` to fetch more rows.\n\n## Troubleshooting\n\n### Authentication failures\n\nIf auto-extraction fails (e.g., Notion desktop app is not installed or not logged in), run the extract command manually for debug output:\n\n```bash\nvibe-notion auth extract --debug\n```\n\nThis shows the Notion directory path and extraction steps to help diagnose the issue.\n\n### Database locked during extraction\n\nIf `auth extract` fails with:\n\n```json\n{\"error\":\"No token_v2 found. Make sure Notion desktop app is installed and logged in.\"}\n```\n\nAnd the Notion desktop app **is** installed and logged in, the cookie database may be locked by the running Notion app. Tell the user to quit the Notion desktop app completely, then retry the command. Once credentials are extracted, the user can reopen Notion.\n\n### `vibe-notion: command not found`\n\nThe `vibe-notion` package is not installed. Run it directly using a package runner. Ask the user which one to use:\n\n```bash\nnpx -y vibe-notion ...\nbunx vibe-notion ...\npnpm dlx vibe-notion ...\n```\n\nIf you already know the user's preferred package runner, use it directly instead of asking.\n\n## Limitations\n\n- Auto-extraction supports macOS and Linux. Windows DPAPI decryption is not yet supported.\n- `token_v2` uses the unofficial internal API and may break if Notion changes it.\n- This is a private\u002Funofficial API and is not supported by Notion.\n","# Vibe Notion\n\nA TypeScript CLI tool that enables AI agents and humans to interact with Notion workspaces through the unofficial private API. Supports full CRUD operations on pages, databases, blocks, search, and user management.\n\n> **Note**: This skill uses Notion's internal\u002Fprivate API (`\u002Fapi\u002Fv3\u002F`), which is separate from the official public API. For official API access, use `vibe-notionbot`.\n\n\n## Which CLI to Use\n\nThis package ships two CLIs. Pick the right one based on your situation:\n\n| | `vibe-notion` (this CLI) | `vibe-notionbot` |\n|---|---|---|\n| API | Unofficial private API | Official Notion API |\n| Auth | `token_v2` auto-extracted from Notion desktop app | `NOTION_TOKEN` env var (Integration token) |\n| Identity | Acts as the user | Acts as a bot |\n| Setup | Zero — credentials extracted automatically | Manual — create Integration at notion.so\u002Fmy-integrations |\n| Database rows | `add-row`, `update-row` | Create via `page create --database` |\n| View management | `view-get`, `view-update`, `view-list`, `view-add`, `view-delete` | Not supported |\n| Workspace listing | Supported | Not supported |\n| Stability | Private API — may break on Notion changes | Official versioned API — stable |\n\n**Decision flow:**\n\n1. If the Notion desktop app is installed → use `vibe-notion` (this CLI)\n2. If `NOTION_TOKEN` is set but no desktop app → use `vibe-notionbot`\n3. If both are available → prefer `vibe-notion` (broader capabilities, zero setup)\n4. If neither → ask the user to set up one of the two\n\n## Important: CLI Only\n\n**Never call Notion's internal API directly.** Always use the `vibe-notion` CLI commands described in this skill. Do not make raw HTTP requests to `notion.so\u002Fapi\u002Fv3\u002F` or use any Notion client library. Direct API calls risk exposing credentials and may trigger Notion's abuse detection, getting the user's account blocked.\n\nIf a feature you need is not supported by `vibe-notion`, let the user know and offer to file a feature request at [devxoul\u002Fvibe-notion](https:\u002F\u002Fgithub.com\u002Fdevxoul\u002Fvibe-notion\u002Fissues) on their behalf. Before submitting, strip out any real user data — IDs, names, emails, tokens, page content, or anything else that could identify the user or their workspace. Use generic placeholders instead and keep the issue focused on describing the missing capability.\n\n## Important: Never Write Scripts\n\n**Never write scripts (Python, TypeScript, Bash, etc.) to automate Notion operations.** The `batch` command already handles bulk operations of any size. Writing a script to loop through API calls is always wrong — use `batch` with `--file` instead.\n\nThis applies even when:\n- You need to create 100+ rows\n- You need cross-references between newly created rows (use multi-pass batch — see [references\u002Fbatch-operations.md](references\u002Fbatch-operations.md#bulk-operations-strategy))\n- The operation feels \"too big\" for a single command\n\nIf you catch yourself thinking \"I should write a script for this,\" stop and use `batch`.\n\n## Quick Start\n\n```bash\n# 1. Find your workspace ID\nvibe-notion workspace list --pretty\n\n# 2. Search for a page\nvibe-notion search \"Roadmap\" --workspace-id \u003Cworkspace-id> --pretty\n\n# 3. Get page content\nvibe-notion page get \u003Cpage-id> --workspace-id \u003Cworkspace-id> --pretty\n\n# 4. Query a database\nvibe-notion database query \u003Ccollection-id> --workspace-id \u003Cworkspace-id> --pretty\n```\n\nCredentials are auto-extracted from the Notion desktop app on first use. No manual setup needed.\n\n> **Important**: `--workspace-id` is required for ALL commands that operate within a specific workspace. Use `vibe-notion workspace list` to find your workspace ID.\n\n## Authentication\n\nCredentials (`token_v2`) are auto-extracted from the Notion desktop app when you run any command. No API keys, OAuth, or manual extraction needed.\n\nOn macOS, your system may prompt for Keychain access on first use — this is normal and required to decrypt the cookie.\n\nThe extracted `token_v2` is stored at `~\u002F.config\u002Fvibe-notion\u002Fcredentials.json` with `0600` permissions.\n\n## Memory\n\nThe agent maintains a `~\u002F.config\u002Fvibe-notion\u002FMEMORY.md` file as persistent memory across sessions. This is agent-managed — the CLI does not read or write this file. Use the `Read` and `Write` tools to manage your memory file.\n\n### Reading Memory\n\nAt the **start of every task**, read `~\u002F.config\u002Fvibe-notion\u002FMEMORY.md` using the `Read` tool to load any previously discovered workspace IDs, page IDs, database IDs, and user preferences.\n\n- If the file doesn't exist yet, that's fine — proceed without it and create it when you first have useful information to store.\n- If the file can't be read (permissions, missing directory), proceed without memory — don't error out.\n\n### Writing Memory\n\nAfter discovering useful information, update `~\u002F.config\u002Fvibe-notion\u002FMEMORY.md` using the `Write` tool. Write triggers include:\n\n- After discovering workspace IDs (from `workspace list`)\n- After discovering useful page IDs, database IDs, collection IDs (from `search`, `page list`, `page get`, `database list`, etc.)\n- After the user gives you an alias or preference (\"call this the Tasks DB\", \"my main workspace is X\")\n- After discovering page\u002Fdatabase structure (parent-child relationships, what databases live under which pages)\n\nWhen writing, include the **complete file content** — the `Write` tool overwrites the entire file.\n\n### What to Store\n\n- Workspace IDs with names\n- Page IDs with titles and parent context\n- Database\u002Fcollection IDs with titles and parent context\n- User-given aliases (\"Tasks DB\", \"Main workspace\")\n- Commonly used view IDs\n- Parent-child relationships (which databases are under which pages)\n- Any user preference expressed during interaction\n\n### What NOT to Store\n\nNever store `token_v2`, credentials, API keys, or any sensitive data. Never store full page content (just IDs and titles). Never store block-level IDs unless they're persistent references (like database blocks).\n\n### Handling Stale Data\n\nIf a memorized ID returns an error (page not found, access denied), remove it from `MEMORY.md`. Don't blindly trust memorized data — verify when something seems off. Prefer re-searching over using a memorized ID that might be stale.\n\n### Format \u002F Example\n\nHere's a concrete example of how to structure your `MEMORY.md`:\n\n```markdown\n# Vibe Notion Memory\n\n## Workspaces\n\n- `abc123-...` — Acme Corp (default)\n\n## Pages (Acme Corp)\n\n- `page-id-1` — Product Roadmap (top-level)\n- `page-id-2` — Q1 Planning (under Product Roadmap)\n\n## Databases (Acme Corp)\n\n- `coll-id-1` — Tasks (under Product Roadmap, views: `view-1`)\n- `coll-id-2` — Contacts (top-level)\n\n## Aliases\n\n- \"roadmap\" → `page-id-1` (Product Roadmap)\n- \"tasks\" → `coll-id-1` (Tasks database)\n\n## Notes\n\n- User prefers --pretty output for search results\n- Main workspace is \"Acme Corp\"\n```\n\n> Memory lets you skip repeated `search` and `workspace list` calls. When you already know an ID from a previous session, use it directly.\n\n## Commands\n\n### Auth Commands\n\n```bash\nvibe-notion auth status     # Check authentication status\nvibe-notion auth logout     # Remove stored token_v2\nvibe-notion auth extract    # Manually re-extract token_v2 (for troubleshooting)\n```\n\n### Page Commands\n\n```bash\n# List pages in a space (top-level only)\nvibe-notion page list --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion page list --workspace-id \u003Cworkspace_id> --depth 2 --pretty\n\n# Get a page and all its content blocks\nvibe-notion page get \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion page get \u003Cpage_id> --workspace-id \u003Cworkspace_id> --limit 50\nvibe-notion page get \u003Cpage_id> --workspace-id \u003Cworkspace_id> --backlinks --pretty\n\n# Create a new page (--parent is optional; omit to create at workspace root)\nvibe-notion page create --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --title \"My Page\" --pretty\nvibe-notion page create --workspace-id \u003Cworkspace_id> --title \"New Root Page\" --pretty\n\n\n# Create a page with markdown content\nvibe-notion page create --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --title \"My Doc\" --markdown '# Hello\\n\\nThis is **bold** text.'\n\n# Create a page with markdown from a file\nvibe-notion page create --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --title \"My Doc\" --markdown-file .\u002Fcontent.md\n\n# Create a page with markdown containing local images (auto-uploaded to Notion)\nvibe-notion page create --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --title \"My Doc\" --markdown-file .\u002Fdoc-with-images.md\n\n# Replace all content on a page with new markdown\nvibe-notion page update \u003Cpage_id> --workspace-id \u003Cworkspace_id> --replace-content --markdown '# New Content'\nvibe-notion page update \u003Cpage_id> --workspace-id \u003Cworkspace_id> --replace-content --markdown-file .\u002Fupdated.md\n\n# Update page title or icon\nvibe-notion page update \u003Cpage_id> --workspace-id \u003Cworkspace_id> --title \"New Title\" --pretty\nvibe-notion page update \u003Cpage_id> --workspace-id \u003Cworkspace_id> --icon \"🚀\" --pretty\n\n# Archive a page\nvibe-notion page archive \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Get page or database row properties (without content blocks — lightweight alternative to page get)\nvibe-notion page properties \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\n```\n\n### Database Commands\n\n```bash\n# Get database schema\nvibe-notion database get \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Query a database (auto-resolves default view)\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --limit 10 --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --view-id \u003Cview_id> --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --search-query \"keyword\" --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --timezone \"America\u002FNew_York\" --pretty\n\n# Query with filter and sort (uses property IDs from database get schema)\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --filter '\u003Cfilter_json>' --pretty\nvibe-notion database query \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --sort '\u003Csort_json>' --pretty\n\n# List all databases in workspace\nvibe-notion database list --workspace-id \u003Cworkspace_id> --pretty\n\n# Create a database\nvibe-notion database create --workspace-id \u003Cworkspace_id> --parent \u003Cpage_id> --title \"Tasks\" --pretty\nvibe-notion database create --workspace-id \u003Cworkspace_id> --parent \u003Cpage_id> --title \"Tasks\" --properties '{\"status\":{\"name\":\"Status\",\"type\":\"select\"}}' --pretty\n\n# Update database title or schema\nvibe-notion database update \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"New Name\" --pretty\nvibe-notion database update \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --properties '{\"status\":{\"name\":\"Status\",\"type\":\"select\"}}' --pretty\nvibe-notion database update \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"New Name\" --properties '{\"status\":{\"name\":\"Status\",\"type\":\"select\"}}' --pretty\n\n# Add a row to a database\nvibe-notion database add-row \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"Row title\" --pretty\nvibe-notion database add-row \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"Row title\" --properties '{\"Status\":\"In Progress\",\"Due\":{\"start\":\"2025-03-01\"}}' --pretty\n\n# Add row with date range\nvibe-notion database add-row \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --title \"Event\" --properties '{\"Due\":{\"start\":\"2026-01-01\",\"end\":\"2026-01-15\"}}' --pretty\n\n# Update properties on an existing database row (row_id from database query)\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Status\":\"Done\"}' --pretty\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Priority\":\"High\",\"Tags\":[\"backend\",\"infra\"]}' --pretty\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Due\":{\"start\":\"2026-06-01\"},\"Status\":\"In Progress\"}' --pretty\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Due\":{\"start\":\"2026-01-01\",\"end\":\"2026-01-15\"}}' --pretty\nvibe-notion database update-row \u003Crow_id> --workspace-id \u003Cworkspace_id> --properties '{\"Related\":[\"\u003Ctarget_row_id>\"]}' --pretty\n\n# Delete a property from a database (cannot delete the title property)\nvibe-notion database delete-property \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --property \"Status\" --pretty\n\n# Get view configuration and property visibility\nvibe-notion database view-get \u003Cview_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Show or hide properties on a view (comma-separated names)\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --show \"ID,Due\" --pretty\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --hide \"Assignee\" --pretty\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --show \"Status\" --hide \"Due\" --pretty\n\n# Reorder columns (comma-separated names in desired order; unmentioned columns appended)\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --reorder \"Name,Status,Priority,Date\" --pretty\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --reorder \"Name,Status\" --show \"Status\" --pretty\n\n# Resize columns (JSON mapping property names to pixel widths)\nvibe-notion database view-update \u003Cview_id> --workspace-id \u003Cworkspace_id> --resize '{\"Name\":200,\"Status\":150}' --pretty\n\n# List all views for a database\nvibe-notion database view-list \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Add a new view to a database (default type: table)\nvibe-notion database view-add \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion database view-add \u003Cdatabase_id> --workspace-id \u003Cworkspace_id> --type board --name \"Board View\" --pretty\n\n# Delete a view from a database (cannot delete the last view)\nvibe-notion database view-delete \u003Cview_id> --workspace-id \u003Cworkspace_id> --pretty\n```\n\n### Block Commands\n\n```bash\n# Get a specific block\nvibe-notion block get \u003Cblock_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion block get \u003Cblock_id> --workspace-id \u003Cworkspace_id> --backlinks --pretty\n\n# List child blocks\nvibe-notion block children \u003Cblock_id> --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion block children \u003Cblock_id> --workspace-id \u003Cworkspace_id> --limit 50 --pretty\nvibe-notion block children \u003Cblock_id> --workspace-id \u003Cworkspace_id> --start-cursor '\u003Cnext_cursor_json>' --pretty\n\n# Append child blocks\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --content '[{\"type\":\"text\",\"properties\":{\"title\":[[\"Hello world\"]]}}]' --pretty\n\n# Append markdown content as blocks\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --markdown '# Hello\\n\\nThis is **bold** text.'\n\n# Append markdown from a file\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --markdown-file .\u002Fcontent.md\n\n# Append markdown with local images (auto-uploaded to Notion)\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --markdown-file .\u002Fdoc-with-images.md\n\n# Append nested markdown (indented lists become nested children blocks)\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --markdown '- Parent item\\n  - Child item\\n    - Grandchild item'\n\n# Append blocks after a specific block (positional insertion)\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --after \u003Cblock_id> --markdown '# Inserted after specific block'\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --after \u003Cblock_id> --content '[{\"type\":\"text\",\"properties\":{\"title\":[[\"Inserted after\"]]}}]'\n\n# Append blocks before a specific block\nvibe-notion block append \u003Cparent_id> --workspace-id \u003Cworkspace_id> --before \u003Cblock_id> --markdown '# Inserted before specific block'\n\n# Update a block\nvibe-notion block update \u003Cblock_id> --workspace-id \u003Cworkspace_id> --content '{\"properties\":{\"title\":[[\"Updated text\"]]}}' --pretty\n\n# Delete a block\nvibe-notion block delete \u003Cblock_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Upload a file as a block (image or file block)\nvibe-notion block upload \u003Cparent_id> --workspace-id \u003Cworkspace_id> --file .\u002Fimage.png --pretty\nvibe-notion block upload \u003Cparent_id> --workspace-id \u003Cworkspace_id> --file .\u002Fdocument.pdf --pretty\nvibe-notion block upload \u003Cparent_id> --workspace-id \u003Cworkspace_id> --file .\u002Fimage.png --after \u003Cblock_id> --pretty\nvibe-notion block upload \u003Cparent_id> --workspace-id \u003Cworkspace_id> --file .\u002Fimage.png --before \u003Cblock_id> --pretty\n\n# Move a block to a new position\nvibe-notion block move \u003Cblock_id> --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --pretty\nvibe-notion block move \u003Cblock_id> --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --after \u003Csibling_id> --pretty\nvibe-notion block move \u003Cblock_id> --workspace-id \u003Cworkspace_id> --parent \u003Cparent_id> --before \u003Csibling_id> --pretty\n```\n\n### Block Types & Rich Text Reference\n\nFor block type JSON format (headings, text, lists, to-do, code, quote, divider) and rich text formatting codes, see [references\u002Fblock-types.md](references\u002Fblock-types.md).\n\n### Comment Commands\n\n```bash\n# List comments on a page\nvibe-notion comment list --page \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# List inline comments on a specific block\nvibe-notion comment list --page \u003Cpage_id> --block \u003Cblock_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Create a comment on a page (starts a new discussion)\nvibe-notion comment create \"This is a comment\" --page \u003Cpage_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Reply to an existing discussion thread\nvibe-notion comment create \"Replying to thread\" --discussion \u003Cdiscussion_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# Get a specific comment by ID\nvibe-notion comment get \u003Ccomment_id> --workspace-id \u003Cworkspace_id> --pretty\n```\n\n## Batch Operations\n\nFor batch command format, supported actions (14 total), operation JSON structure, output format, fail-fast behavior, bulk operations strategy (multi-pass pattern), and rate limit handling, see [references\u002Fbatch-operations.md](references\u002Fbatch-operations.md).\n\n**Quick usage:**\n\n```bash\n# Inline JSON\nvibe-notion batch --workspace-id \u003Cworkspace_id> '\u003Coperations_json>'\n\n# From file (for large payloads)\nvibe-notion batch --workspace-id \u003Cworkspace_id> --file .\u002Foperations.json '[]'\n```\n\n### Search Command\n\n```bash\n# Search across workspace (--workspace-id is required)\nvibe-notion search \"query\" --workspace-id \u003Cworkspace_id> --pretty\nvibe-notion search \"query\" --workspace-id \u003Cworkspace_id> --limit 10 --pretty\nvibe-notion search \"query\" --workspace-id \u003Cworkspace_id> --start-cursor \u003Coffset> --pretty\nvibe-notion search \"query\" --workspace-id \u003Cworkspace_id> --sort lastEdited --pretty\n```\n\n### User Commands\n\n```bash\n# Get current user info\nvibe-notion user me --pretty\n\n# Get a specific user\nvibe-notion user get \u003Cuser_id> --workspace-id \u003Cworkspace_id> --pretty\n\n# List users in a workspace\nvibe-notion user list --workspace-id \u003Cworkspace_id> --pretty\n```\n\n## Output Format\n\nAll commands output JSON by default. Use `--pretty` for human-readable output.\n\nFor JSON response shapes (search, database query, page get, block get, backlinks), `$hints` schema warnings, and detailed examples, see [references\u002Foutput-format.md](references\u002Foutput-format.md).\n\n## When to Use `--backlinks`\n\nBacklinks reveal which pages\u002Fdatabases **link to** a given page. This is critical for efficient navigation.\n\n**Use `--backlinks` when:**\n- **Tracing relations**: A search result looks like a select option, enum value, or relation target (e.g., a plan name or category). Backlinks instantly reveal all rows\u002Fpages that reference it via relation properties — no need to hunt for the parent database.\n- **Finding references**: You found a page and want to know what other pages mention or link to it.\n- **Reverse lookups**: Instead of querying every database to find rows pointing to a page, use backlinks on the target page to get them directly.\n\n**Example — finding who uses a specific plan:**\n```bash\n# BAD: 15 API calls — search, open empty pages, trace parents, find database, query\nvibe-notion search \"Enterprise Plan\" ...\nvibe-notion page get \u003Cplan-page-id> ...  # empty\nvibe-notion block get \u003Cplan-page-id> ...  # find parent\n# ... many more calls to discover the database\n\n# GOOD: 2-3 API calls — search, then backlinks on the target\nvibe-notion search \"Enterprise Plan\" ...\nvibe-notion page get \u003Cplan-page-id> --backlinks --pretty\n# → backlinks immediately show all people\u002Frows linked to this plan\n```\n\n## Pagination\n\nCommands that return lists support pagination via `has_more`, `next_cursor` fields:\n\n- **`block children`**: Cursor-based. Pass `next_cursor` value from previous response as `--start-cursor`.\n- **`search`**: Offset-based. Pass `next_cursor` value (a number) as `--start-cursor`.\n- **`database query`**: Use `--limit` to control page size. `has_more` indicates more results exist, but the private API does not support cursor-based pagination — increase `--limit` to fetch more rows.\n\n## Troubleshooting\n\n### Authentication failures\n\nIf auto-extraction fails (e.g., Notion desktop app is not installed or not logged in), run the extract command manually for debug output:\n\n```bash\nvibe-notion auth extract --debug\n```\n\nThis shows the Notion directory path and extraction steps to help diagnose the issue.\n\n### Database locked during extraction\n\nIf `auth extract` fails with:\n\n```json\n{\"error\":\"No token_v2 found. Make sure Notion desktop app is installed and logged in.\"}\n```\n\nAnd the Notion desktop app **is** installed and logged in, the cookie database may be locked by the running Notion app. Tell the user to quit the Notion desktop app completely, then retry the command. Once credentials are extracted, the user can reopen Notion.\n\n### `vibe-notion: command not found`\n\nThe `vibe-notion` package is not installed. Run it directly using a package runner. Ask the user which one to use:\n\n```bash\nnpx -y vibe-notion ...\nbunx vibe-notion ...\npnpm dlx vibe-notion ...\n```\n\nIf you already know the user's preferred package runner, use it directly instead of asking.\n\n## Limitations\n\n- Auto-extraction supports macOS and Linux. Windows DPAPI decryption is not yet supported.\n- `token_v2` uses the unofficial internal API and may break if Notion changes it.\n- This is a private\u002Funofficial API and is not supported by Notion.\n",{"name":5,"version":24,"metadata":25,"description":7,"allowed-tools":33},"1.2.2",{"openclaw":26},{"install":27,"requires":31},[28],{"bins":29,"kind":30,"package":5},[5],"node",{"bins":32},[5],"Bash(vibe-notion:*)","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Fdevxoul\u002Fvibe-notion",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill vibe-notion",{"tool":49,"command":50},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill vibe-notion",{"tool":52,"command":53},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill vibe-notion","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fdevxoul\u002Fvibe-notion\u002FSKILL.md",true,[],[58,66,73,80,87,94],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":65},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":65},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":65},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":65},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":65},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":65},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]