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
For a project with an organization template, first call get_project_organization(project_root_id). Choose a section using its purpose and the page content, then pass organization_placement: {mode: "section", project_root_id: "...", expected_binding_revision: 1, section_key: "..."} Omit parent_id: core resolves the section and creates only missing section pages on that path. To reuse an existing section page, explicitly include it in anchor_page_ids. Only if the user requests an exception, use mode: "user_override" with their reason and a parent_id inside the same project (omit parent_id to use the project root). This workflow makes no server-side LLM call. Placement is the agent's decision.
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="<parent_page_id>")
Input 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) | |
| organization_placement | No |