MindWiki

https://mindwiki.io/docs
Admin
MindWiki is a comprehensive documentation set detailing a knowledge management system that helps...
Tokens:26,679
Snippets:377
Trust Score:2.9
Update:4 months ago
Show doc for...
Tokens:
Raw
### Example ChatGPT Prompt for Search

Source: https://mindwiki.io/docs/chatgpt

An example prompt to initiate a search within your MindWiki vault. ChatGPT will use the 'search' tool and potentially 'fetch' to retrieve relevant pages.

```text
Search my MindWiki vault for notes about onboarding metrics 
and tell me what's there.
```

--------------------------------

### Example AI Query for Vault Content

Source: https://mindwiki.io/docs/quick-start

This is an example prompt to ask your connected AI to search and summarize content from your MindWiki vault. It demonstrates verifying the AI connection by querying your personal knowledge base.

```text
Search my MindWiki for anything I've written about onboarding. Summarize what's there.
```

--------------------------------

### Prompting AI with Context Pack

Source: https://mindwiki.io/docs/context-packs

Example of how to instruct an AI client to load a specific context pack and then assist with a task. This demonstrates the user-facing interaction for utilizing context packs.

```text
Load the onboarding-redesign context pack from MindWiki and 
help me think through the next milestone.
```

--------------------------------

### Example Prompt for Capturing Insights

Source: https://mindwiki.io/docs/claude-desktop

This prompt demonstrates how to instruct Claude Desktop to capture information directly into MindWiki. Claude will call the `mindwiki_capture` tool.

```text
Capture this synthesis as a new MindWiki page in capture/
```

--------------------------------

### Example Prompt for Working with Project Context

Source: https://mindwiki.io/docs/claude-desktop

Use this prompt to have Claude Desktop load a specific context pack from MindWiki and brainstorm related ideas. This showcases Claude's ability to work with project-specific information.

```text
Load the onboarding-redesign context pack and brainstorm the next milestone.
```

--------------------------------

### Example Prompt for Verifying MindWiki Integration

Source: https://mindwiki.io/docs/claude-desktop

Use this prompt to test if Claude Desktop can successfully interact with MindWiki tools. Claude will search, read, and process information from your MindWiki pages.

```text
Read my MindWiki page about agent-native memory and suggest 
one useful follow-up.
```

--------------------------------

### Example YAML Frontmatter and Markdown

Source: https://mindwiki.io/docs/vault-structure

Pages are plain markdown with optional YAML frontmatter. The body uses standard markdown plus [[wikilinks]] between pages.

```yaml
---
title: A Page About Something
area: research
type: note
created: 2026-05-09
updated: 2026-05-09
tags: [example, draft]
---

```

```markdown
The body uses standard markdown plus [[wikilinks]] between pages.
```

--------------------------------

### Codex Search Command Example

Source: https://mindwiki.io/docs/codex

Example of using Codex to search MindWiki for specific information and summarize the results. This command invokes the 'mindwiki_search' tool.

```bash
> Search my MindWiki for anything about CI failures and summarize
```

--------------------------------

### Example Claude.ai Prompt for Vault Search

Source: https://mindwiki.io/docs/claude-ai

An example prompt to initiate a search within your MindWiki vault using Claude.ai. This prompt triggers the 'mindwiki_search' tool.

```text
Search my MindWiki vault for anything I've written about onboarding 
and summarize the highlights.
```

--------------------------------

### Example Prompt for Auditing Agent Activity

Source: https://mindwiki.io/docs/claude-desktop

This prompt instructs Claude Desktop to retrieve and summarize your MindWiki agent activity for a specified period. It helps in reviewing past actions and understanding usage patterns.

```text
Show me my MindWiki agent activity from this week and summarize what I've been doing.
```

--------------------------------

### mindwiki_get_agent_operating_guide

Source: https://mindwiki.io/docs/mcp-tools

Retrieves the user's Agent Operating Guide, detailing safe behavior, vault model, and workflows.

```APIDOC
## mindwiki_get_agent_operating_guide

### Description
Return the user's Agent Operating Guide: the safe-behavior contract, vault model, tool guide, organization guidance, workflows, and optional memory handshake that connected AI clients should read before substantive work.

### Method
mindwiki_get_agent_operating_guide

### Parameters
None

### Scope
read
```

--------------------------------

### List Pages in MindWiki Vault

Source: https://mindwiki.io/docs/claude-code

Example of listing pages in a MindWiki vault using the `mindwiki_list_pages` tool. Requires the `projects/` prefix.

```bash
> List the pages in my MindWiki vault under projects/
```

--------------------------------

### macOS App Slash Command for Table Insertion

Source: https://mindwiki.io/docs/slash-commands

Opens a row x column picker to insert an interactive table in the macOS app. The example shows the command itself.

```markdown
/table
```

--------------------------------

### Codex Capture Command Example

Source: https://mindwiki.io/docs/codex

Example of using Codex to capture terminal output insights directly to MindWiki. This command invokes the 'mindwiki_capture' tool and saves to the 'capture/' directory.

```bash
> Capture this terminal output insight to my MindWiki: "CI flake 
  was a missing env var, not a real failure."
```

--------------------------------

### Frontmatter with Custom Fields

Source: https://mindwiki.io/docs/frontmatter-and-metadata

Example demonstrating custom fields beyond the canonical ones. MindWiki auto-detects types for UI rendering. Includes fields like attendees, status, priority, deadline, client, budget, shipped, and source.

```yaml
---
title: Q3 Planning Meeting
area: projects
type: meeting-notes
attendees: [Alice, Bob, Carol]
status: in-progress
priority: high
deadline: 2026-09-15
client: [[Acme Corp]]
budget: 25000
shipped: false
source: https://docs.example.com/spec
---
```

--------------------------------

### Example Conflict File Naming Convention

Source: https://mindwiki.io/docs/conflicts

Conflict files are named by appending '.conflict-' followed by the device name and a timestamp to the original filename. This naming convention helps identify the source and timing of the conflict.

```text
my-page.conflict-macbook-pro-1747100000000.md
```

--------------------------------

### Get Relevant Context Pages

Source: https://mindwiki.io/docs/context-packs

Retrieves pages the AI deems most relevant to a given goal and optional constraints. Use this when you want the AI to intelligently select context rather than loading a predefined pack.

```python
mindwiki_get_relevant_context
```

--------------------------------

### Ask MindWiki a question

Source: https://mindwiki.io/docs/api-access

Query MindWiki with a natural language question to get a synthesized answer. You can specify the maximum number of pages to consider for the answer.

```bash
curl -X POST "https://api.mindwiki.io/vault/ask" \
  -H "Authorization: Bearer $MINDWIKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What recent notes mention agent-native memory?",
    "max_pages": 5
  }'
```

--------------------------------

### Live Styling Reference - Tip Callout

Source: https://mindwiki.io/docs/the-editor

Markdown tip callout syntax renders as a styled tip block.

```markdown
> [!tip] ...

```

--------------------------------

### Vault statistics

Source: https://mindwiki.io/docs/api-access

Get statistics about your vault, such as page count, word count, and link count. Requires the `read` scope.

```APIDOC
## GET /vault/stats

### Description
Get statistics for your vault.

### Method
GET

### Endpoint
/vault/stats

### Parameters
#### Query Parameters
- **scope** (string) - Required - Must be `read`.

### Response
#### Success Response (200)
- **page_count** (integer) - The total number of pages.
- **word_count** (integer) - The total word count across all pages.
- **link_count** (integer) - The total number of internal links.

#### Response Example
{
  "page_count": 150,
  "word_count": 50000,
  "link_count": 1200
}
```

--------------------------------

### Live Styling Reference - Tables

Source: https://mindwiki.io/docs/the-editor

Markdown pipe-separated rows render as interactive tables on macOS.

```markdown
Pipe-separated `| ` rows

```

--------------------------------

### Capture Thought to MindWiki Vault

Source: https://mindwiki.io/docs/claude-code

Example of capturing a thought to the MindWiki vault using the `mindwiki_capture` tool. The content is saved to the `capture/` directory.

```bash
> Capture this thought to my MindWiki vault: "Auth migration deferred to Q3."
```

--------------------------------

### Live Styling Reference - Bold

Source: https://mindwiki.io/docs/the-editor

Markdown bold syntax renders as bold text.

```markdown
**bold**

```

--------------------------------

### List All Context Packs

Source: https://mindwiki.io/docs/context-packs

Lists all available context packs. This is a foundational tool for managing and understanding your saved context bundles.

```python
mindwiki_list_context_packs
```

--------------------------------

### Get Automation Runs

Source: https://mindwiki.io/docs/pro-automation

Retrieve a list of automation runs. This endpoint is mentioned as a way to view automation runs alongside human activity.

```APIDOC
## GET /vault/automation-runs

### Description
Retrieve a list of automation runs. This endpoint is useful for monitoring the status and history of automation jobs.

### Method
GET

### Endpoint
https://api.mindwiki.io/vault/automation-runs

### Parameters
(No specific parameters are detailed in the source.)

### Request Example
(No request example is provided in the source.)

### Response
#### Success Response (200)
(The structure of the success response is not detailed in the source.)

#### Error Handling
(Error handling details are not provided in the source.)
```

--------------------------------

### Get Agent Activity Log

Source: https://mindwiki.io/docs/sessions-and-activity

Retrieve the recent activity log for an AI client. This is useful for prompts that require summarizing past actions.

```prompt
Show me everything you've written to my MindWiki vault this week and summarize.
```

--------------------------------

### Live Styling Reference - Wikilink

Source: https://mindwiki.io/docs/the-editor

Markdown wikilink syntax renders as a navigable wikilink.

```markdown
[[Page Name]]

```

--------------------------------

### Live Styling Reference - Heading

Source: https://mindwiki.io/docs/the-editor

Markdown headings render as levels 1-6.

```markdown
# Heading

```

--------------------------------

### Undo/Redo

Source: https://mindwiki.io/docs/the-editor

Use `Cmd+Z` for undo and `Cmd+Shift+Z` for redo.

```keyboard shortcut
Cmd+Z
```

```keyboard shortcut
Cmd+Shift+Z
```

--------------------------------

### Get Vault Summary via REST API

Source: https://mindwiki.io/docs/sessions-and-activity

Fetch recent activity, sessions, pending proposals, and vault health in a single call. Requires 'read' scope.

```bash
curl -H "Authorization: Bearer $MINDWIKI_API_KEY" \
  "https://api.mindwiki.io/vault/agents/summary"
```

--------------------------------

### Live Styling Reference - Note Callout

Source: https://mindwiki.io/docs/the-editor

Markdown note callout syntax renders as a styled note block.

```markdown
> [!note] ...

```

--------------------------------

### Live Styling Reference - Inline Link

Source: https://mindwiki.io/docs/the-editor

Markdown inline link syntax renders as a clickable link.

```markdown
[label](url)

```

--------------------------------

### Force Save

Source: https://mindwiki.io/docs/the-editor

Use `Cmd+S` to force an immediate save of changes in the editor.

```keyboard shortcut
Cmd+S
```

--------------------------------

### Download the full vault

Source: https://mindwiki.io/docs/api-access

Download your entire vault as a zip archive. Requires the `read` scope.

```APIDOC
## GET /vault/export

### Description
Download the full vault as a zip archive.

### Method
GET

### Endpoint
/vault/export

### Parameters
#### Query Parameters
- **scope** (string) - Required - Must be `read`.

### Response
#### Success Response (200)
- The response body will be a zip file containing the vault contents.
```

--------------------------------

### Basic Wikilink Syntax

Source: https://mindwiki.io/docs/wikilinks-and-backlinks

Use this syntax to create a link to another page. The link will resolve to a page with the matching title or filename.

```markdown
[[Target Page]]
```

--------------------------------

### Live Styling Reference - Task Checkbox

Source: https://mindwiki.io/docs/the-editor

Markdown task list syntax renders as a checkbox.

```markdown
- [ ] task

```

--------------------------------

### Live Styling Reference - Inline Code

Source: https://mindwiki.io/docs/the-editor

Markdown inline code syntax renders as inline code.

```markdown
`code`

```

--------------------------------

### Live Styling Reference - Wikilink with Display Text

Source: https://mindwiki.io/docs/the-editor

Markdown wikilink syntax with a display text alias renders as a navigable wikilink with custom text.

```markdown
[[Page Name| Display Text]]

```

--------------------------------

### Claude.ai Prompts and Corresponding MindWiki MCP Tools

Source: https://mindwiki.io/docs/claude-ai

A reference table showing common prompts for Claude.ai and the specific MindWiki MCP tools they invoke. These demonstrate the range of interactions possible.

```markdown
Prompt| Tool used  
---|---  
"Search my MindWiki for X"| `mindwiki_search`  
"Read my page at projects/foo/spec.md"| `mindwiki_read_page`  
"What do I know about X?"| `mindwiki_ask`  
"Capture this conversation insight to my vault"| `mindwiki_capture`  
"Find pages similar to my onboarding-redesign page"| `mindwiki_similar`  
"Show me my MindWiki graph and highlight hubs"| `mindwiki_graph`  
"List my pages under projects/"| `mindwiki_list_pages`  
"Propose a merge of these three pages"| `mindwiki_create_proposal`  
```

--------------------------------

### Live Styling Reference - Warning Callout

Source: https://mindwiki.io/docs/the-editor

Markdown warning callout syntax renders as a styled warning block.

```markdown
> [!warning] ...

```

--------------------------------

### Create or update a page

Source: https://mindwiki.io/docs/api-access

Create a new page or update an existing one in your vault. This endpoint supports setting the path, content, and a commit message. For updates, consider using the `base_hash` for optimistic concurrency.

```bash
curl -X POST "https://api.mindwiki.io/vault/page" \
  -H "Authorization: Bearer $MINDWIKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "capture/external-integration.md",
    "content": "---\ntitle: External Integration
area: capture
type: note
---\n
# External Integration

Created through the API.",
    "message": "Created from API"
  }'
```

--------------------------------

### Quick capture

Source: https://mindwiki.io/docs/api-access

Quickly capture content into the `capture/` directory. Requires the `write` scope.

```APIDOC
## POST /vault/capture

### Description
Quick capture of content into the `capture/` directory.

### Method
POST

### Endpoint
/vault/capture

### Parameters
#### Query Parameters
- **scope** (string) - Required - Must be `write`.

#### Request Body
- **title** (string) - Required - The title for the captured note.
- **source** (string) - Optional - The source of the capture (e.g., "readwise").
- **content** (string) - Required - The content to capture.

### Request Example
{
  "title": "Readwise highlight",
  "source": "readwise",
  "content": "A saved highlight or note goes here."
}

### Response
#### Success Response (200)
- **path** (string) - The path where the content was saved (e.g., `capture/YYYY-MM-DD-slug.md`).

#### Response Example
{
  "path": "capture/2023-10-27-readwise-highlight.md"
}
```

--------------------------------

### Bold Formatting

Source: https://mindwiki.io/docs/the-editor

Use `Cmd+B` to apply or remove bold formatting.

```keyboard shortcut
Cmd+B
```

--------------------------------

### Insert Slash Command

Source: https://mindwiki.io/docs/the-editor

Type `/` to open a menu of insertable blocks, which can be filtered by typing.

```markdown
/

```

--------------------------------

### Wikilink Wrap (macOS)

Source: https://mindwiki.io/docs/the-editor

Select text and press `Cmd+Shift+K` to wrap it in a wikilink in the macOS app.

```keyboard shortcut
Cmd+Shift+K
```

--------------------------------

### Heading Formatting (macOS)

Source: https://mindwiki.io/docs/the-editor

Use `Cmd+1` through `Cmd+6` while a line is selected to set heading levels 1-6 in the macOS app.

```keyboard shortcut
Cmd+1
```

```keyboard shortcut
Cmd+6
```

--------------------------------

### Default Vault Folder

Source: https://mindwiki.io/docs/vault-structure

When you create your account, your vault is provisioned with a single user-facing folder: 'capture/'.

```text
capture/
```

--------------------------------

### Capture content into MindWiki

Source: https://mindwiki.io/docs/api-access

Quickly capture content from external tools into the 'capture/' directory. This endpoint is useful for saving highlights, notes, or other snippets. The content will be saved as a markdown file with a timestamped name.

```bash
curl -X POST "https://api.mindwiki.io/vault/capture" \
  -H "Authorization: Bearer $MINDWIKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Readwise highlight",
    "source": "readwise",
    "content": "A saved highlight or note goes here."
  }'
```

--------------------------------

### Load a Named Context Pack

Source: https://mindwiki.io/docs/context-packs

Loads a specific context pack by its name, retrieving all associated pages. Use this when you know the exact context bundle required for an AI task.

```python
mindwiki_get_context_pack
```

--------------------------------

### REST API Capture Endpoint

Source: https://mindwiki.io/docs/capture-methods

Utilize the capture endpoint via a POST request with your API key to programmatically add content to your vault. Requires the `write` scope.

```bash
curl -X POST "https://api.mindwiki.io/vault/capture" \
  -H "Authorization: Bearer $MINDWIKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Readwise highlight","source":"readwise","content":"A saved highlight goes here."}'
```

--------------------------------

### Filtering Slash Commands by Partial Match

Source: https://mindwiki.io/docs/slash-commands

Demonstrates how to filter slash commands using partial matches. Typing '/cal' narrows down to all callout commands.

```markdown
/cal
```

--------------------------------

### Live Styling Reference - Italic

Source: https://mindwiki.io/docs/the-editor

Markdown italic syntax renders as italic text.

```markdown
*italic*

```

--------------------------------

### Web Quick Capture

Source: https://mindwiki.io/docs/capture-methods

Use the Quick Capture feature on the web app dashboard to quickly type or paste thoughts, which are then saved as new markdown files in your `capture/` folder.

```APIDOC
## Web Quick Capture

### Description
Access the Quick Capture surface from the web app's account dashboard. This method allows you to rapidly input thoughts or paste content directly into a new markdown file that will be saved in your `capture/` folder without requiring manual file naming or folder selection.

### Usage
Navigate to the account dashboard at mindwiki.io/account, use the Quick Capture input field, and click 'Capture'.
```

--------------------------------

### Create or update a page

Source: https://mindwiki.io/docs/api-access

Create a new page or update an existing one. Supports optimistic concurrency. Requires the `write` scope.

```APIDOC
## POST /vault/page

### Description
Create or update a page in your vault.

### Method
POST

### Endpoint
/vault/page

### Parameters
#### Query Parameters
- **scope** (string) - Required - Must be `write`.

#### Request Body
- **path** (string) - Required - The full path for the page (e.g., `notes/new-page.md`).
- **content** (string) - Required - The content of the page, including frontmatter.
- **message** (string) - Optional - A commit message for the change.
- **base_hash** (string) - Optional - The expected hash of the page for optimistic concurrency.

### Request Example
{
  "path": "notes/api-created.md",
  "content": "---\ntitle: API Created Page\n---

This page was created via the API.",
  "message": "Created via API"
}

### Response
#### Success Response (200)
- **path** (string) - The path of the created or updated page.
- **hash** (string) - The new hash of the page.

#### Error Response (409 Conflict)
- **code** (string) - "CONFLICT"
- **message** (string) - "Optimistic concurrency check failed."
- **actual_hash** (string) - The current hash of the page on the server.

#### Response Example
{
  "path": "notes/api-created.md",
  "hash": "newhash12345"
}
```

--------------------------------

### Live Styling Reference - Fenced Code Block

Source: https://mindwiki.io/docs/the-editor

Markdown fenced code blocks render as formatted code blocks with language highlighting.

```markdown
 ```lang 
 block

```

--------------------------------

### mindwiki_get_context_pack

Source: https://mindwiki.io/docs/mcp-tools

Loads a specified context pack and all its associated pages.

```APIDOC
## mindwiki_get_context_pack

### Description
Load a named context pack with all its included pages.

### Method
mindwiki_get_context_pack

### Parameters
#### Query Parameters
- **name** (string) - Required - The name of the context pack to load.

### Scope
read
```

--------------------------------

### In-app Page Creation

Source: https://mindwiki.io/docs/capture-methods

Create new pages or folders directly within the macOS app (Cmd+N / Cmd+Shift+N) or the web app via the command palette (Cmd+K), allowing you to bypass the capture inbox and place content in specific folders.

```APIDOC
## In-app Page Creation

### Description
Create new markdown pages or folders directly within a desired location in your vault, bypassing the default `capture/` inbox. This is ideal for content that has a clear, predefined destination.

### Usage
- **macOS app**: Use `Cmd+N` to create a new page and `Cmd+Shift+N` to create a new folder. The new item will be created in the currently focused location in the file tree.
- **Web app**: Open the command palette with `Cmd+K` and select either 'New page' or 'New folder'.
```

--------------------------------

### Pinning a Page

Source: https://mindwiki.io/docs/frontmatter-and-metadata

Use the `pinned: true` field to add a page to your favorites list, which is surfaced in the sidebar. This is equivalent to clicking the pin icon in the Properties panel.

```yaml
---
title: Daily Hub
pinned: true
---
```

--------------------------------

### mindwiki_list_context_packs

Source: https://mindwiki.io/docs/mcp-tools

Lists all curated context packs available within the vault.

```APIDOC
## mindwiki_list_context_packs

### Description
List curated context packs available in your vault.

### Method
mindwiki_list_context_packs

### Parameters
None

### Scope
read
```

--------------------------------

### Codex MCP Configuration with API Key

Source: https://mindwiki.io/docs/codex

Add MindWiki as an MCP server in your Codex configuration using a personal API key. Ensure the key is kept secure and not committed to repositories.

```json
{
  "mcpServers": {
    "mindwiki": {
      "url": "https://api.mindwiki.io/mcp?token=YOUR_API_KEY"
    }
  }
}
```

--------------------------------

### MCP Capture from AI

Source: https://mindwiki.io/docs/capture-methods

Utilize the `mindwiki_capture` tool from AI clients connected via MCP (e.g., Claude, ChatGPT) to save content directly into your `capture/` folder by issuing a command like 'Capture this to my MindWiki vault: ...'.

```APIDOC
## MCP Capture from AI

### Description
Integrate with AI clients connected through MCP to capture content directly into your MindWiki vault. By using the `mindwiki_capture` tool, you can instruct AI models to save specified text into your `capture/` folder, creating a new dated markdown file.

### Usage
Within an AI chat interface that supports MCP tools, issue a command such as: `Capture this to my MindWiki vault: <your content here>`.

### Requirements
- Requires the `write` scope on the connected token. OAuth connections have this by default; API keys must have it explicitly selected.
```

--------------------------------

### Ask a question

Source: https://mindwiki.io/docs/api-access

Ask a question about your vault content and receive a synthesized answer. Requires the `read` scope.

```APIDOC
## POST /vault/ask

### Description
Ask a question and get a synthesized answer from your vault.

### Method
POST

### Endpoint
/vault/ask

### Parameters
#### Query Parameters
- **scope** (string) - Required - Must be `read`.

#### Request Body
- **question** (string) - Required - The question to ask.
- **max_pages** (integer) - Optional - The maximum number of pages to consider for the answer.

### Request Example
{
  "question": "What are the main goals of project X?",
  "max_pages": 5
}

### Response
#### Success Response (200)
- **answer** (string) - The synthesized answer to the question.
- **sources** (array) - A list of pages that were used to generate the answer.

#### Response Example
{
  "answer": "The main goals of project X are to improve user engagement and streamline the onboarding process.",
  "sources": ["project_x/goals.md", "project_x/overview.md"]
}
```

--------------------------------

### Live Styling Reference - Horizontal Rule

Source: https://mindwiki.io/docs/the-editor

Markdown horizontal rule syntax renders as a horizontal line.

```markdown
---

```

--------------------------------

### Automated Daily Backup Script

Source: https://mindwiki.io/docs/export-and-backup

A bash script to automate daily backups of your MindWiki vault using the export API. It saves the zip file with a date-stamped name. Requires a 'read' scope API key.

```bash
# Daily backup script (run via cron)
DATE=$(date +%Y-%m-%d)
curl -H "Authorization: Bearer $MINDWIKI_API_KEY" \
  -o "$HOME/mindwiki-backups/$DATE.zip" \
  "https://api.mindwiki.io/vault/export"
```

--------------------------------

### Find in Page

Source: https://mindwiki.io/docs/the-editor

Use `Cmd+F` to open the find-in-page functionality within the editor.

```keyboard shortcut
Cmd+F
```

--------------------------------

### Comment/Uncomment Code

Source: https://mindwiki.io/docs/the-editor

Use `Cmd+/` to comment or uncomment selected code.

```keyboard shortcut
Cmd+/
```

--------------------------------

### fetch

Source: https://mindwiki.io/docs/mcp-tools

Fetches a single page by its ID or path in a read-only manner.

```APIDOC
## fetch

### Description
Read-only fetch of a single page by id or path.

### Method
fetch

### Parameters
#### Query Parameters
- **id** (string) - Required - Typically returned by `search`. Can be a page ID or path.

### Scope
read
```

--------------------------------

### Live Styling Reference - Collapsible Toggle (macOS)

Source: https://mindwiki.io/docs/the-editor

Markdown collapsible toggle syntax renders as a collapsible section in the macOS app.

```markdown
> [!toggle] Title

```

--------------------------------

### mindwiki_create_proposal

Source: https://mindwiki.io/docs/mcp-tools

Creates a pending proposal for a vault change, which can be reviewed later.

```APIDOC
## mindwiki_create_proposal

### Description
Create a pending proposal for a vault change instead of writing directly. The proposal lands in your review queue.

### Method
mindwiki_create_proposal

### Parameters
#### Request Body
- **type** (string) - Required - The type of proposal (e.g., `edit_note`, `merge_notes`, `move_note`, `add_tags`, `update_links`, `archive_note`, `flag_contradiction`, `create_decision`, `create_summary`).
- **summary** (string) - Required - A summary of the proposed change.
- **agent** (string) - Optional - The agent initiating the proposal.
- **target_files** (array of strings) - Optional - The files targeted by the proposal.
- **rationale** (string) - Optional - The rationale behind the proposal.
- **diff** (string) - Optional - The diff content for the proposed change.
- **payload** (object) - Optional - Additional payload data for the proposal.

### Scope
write
```

--------------------------------

### macOS App Slash Commands for File Attachments

Source: https://mindwiki.io/docs/slash-commands

These commands open a native file picker in the macOS app to select and embed various file types. Selected files are stored in the '_assets/' directory.

```markdown
/attachment
```

```markdown
/image
```

```markdown
/audio
```

```markdown
/video
```

```markdown
/pdf
```

--------------------------------

### Codex MCP Configuration with OAuth

Source: https://mindwiki.io/docs/codex

Configure MindWiki as an MCP server in Codex for environments supporting remote MCP and OAuth. The first invocation will prompt for browser approval.

```json
{
  "mcpServers": {
    "mindwiki": {
      "url": "https://api.mindwiki.io/mcp"
    }
  }
}
```
Tokens:
Raw