create_page
Create a new page. The page is automatically assigned to a folder based on:
Explicit folder_id (if provided)
Parent page's folder (if parent_id provided)
Working directory (if cwd provided) - auto-creates folder if needed
IMPORTANT: For root pages (no parent_id), this tool automatically checks if a page already exists with the same root_path or repo_url. If found, it returns the existing page instead of creating a duplicate.
Example - simple page creation with auto-folder: create_page(title="Bug Notes", cwd="/path/to/project") -> Creates page, auto-creates "project" folder if needed
Example - sub-page (inherits folder from parent): create_page(title="API Docs", parent_id="")
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Current working directory - used to auto-detect/create folder | |
| tags | No | Page tags for categorization. Preset: documentation, architecture, testing, feature, decision, tasks, reference. Custom tags also allowed. | |
| type | No | Page type. 'page' (default) for regular pages, 'dataspace' for structured agent data pages with datastore/state/log blocks. | |
| title | Yes | Title of the new page | |
| repo_url | No | Git repository URL (e.g., https://github.com/user/repo) | |
| folder_id | No | Optional folder ID to assign the page to | |
| parent_id | No | Optional parent page ID - inherits folder from parent | |
| root_path | No | Codebase root path (local filesystem) |