YouMind CLI Skill

Use the official youmind CLI as the default interface to YouMind.

This skill is optimized for OpenClaw usage, so it should help with both:

• discovering what YouMind APIs exist
• directly executing common YouMind tasks

Runtime Assumptions

• Prefer the official CLI over older custom local wrappers.
• The CLI is installed at ~/.local/bin/youmind in this environment.
• If youmind is not in PATH, use:

export PATH="$HOME/.local/bin:$PATH"

• Authenticate with YOUMIND_API_KEY or --api-key.
• Prefer read-first exploration before writes when the exact API is not already known.

Current Local Status

This environment has already been validated.

Installed CLI:

npm install -g @youmind-ai/cli --prefix "$HOME/.local"

Verified working commands:

• youmind search
• youmind info
• youmind call

Verified working APIs in this workspace:

• createBoard
• getBoard
• createNote
• createMaterialByUrl
• listMaterials

Known APIs discovered from the installed CLI include:

• Boards: listBoards, getBoard, createBoard, updateBoard, trashBoard, getDefaultBoard
• Notes: createNote, updateNote
• Materials: createMaterialByUrl, getMaterial, listMaterials, moveMaterials, trashMaterial, publishMaterial, createMaterialGroup, updateMaterialGroup, ungroupMaterialGroup
• Crafts: listCrafts, getCraft, publishCraft, trashCraft, createCraftGroup, updateCraftGroup, ungroupCraftGroup, moveCrafts
• Picks: createPick, updatePick, trashPick
• Documents: createDocument, createDocumentByMarkdown, updateDocument
• Slides: createSlides, updateSlides
• Chats: createChat, sendMessage, listChats, getChat, listMessages
• Skills: createSkill, getSkill, updateSkill, installSkill, trashSkill
• Search: search, webSearch
• Scheduled tasks: createScheduledTask, updateScheduledTask, trashScheduledTask, getScheduledTask, listScheduledTasks

Core Workflow

Use this three-step pattern when the exact API is unclear:

1. Search for a relevant API
2. Inspect the schema
3. Execute the API call

Example:

export PATH="$HOME/.local/bin:$PATH"
export YOUMIND_API_KEY="..."
youmind search board
youmind info createBoard
youmind call createBoard '{"name":"Research Notes","icon":{"name":"folder","color":"#3B82F6"}}'

If the exact API is already known and simple, it is fine to call it directly.

Command Reference

Search available APIs

youmind search [query]

Use this to discover endpoint names by keyword.

Examples:

youmind search
youmind search board
youmind search note
youmind search material
youmind search craft
youmind search pick
youmind search document
youmind search slides
youmind search chat
youmind search skill
youmind search scheduled

Inspect API schema

youmind info <apiName>

Use this before writes or whenever required fields are uncertain.

Examples:

youmind info createBoard
youmind info createNote
youmind info createMaterialByUrl
youmind info createDocumentByMarkdown
youmind info createSlides
youmind info createChat

Execute an API call

youmind call <apiName> [params]

Supported parameter styles:

# Key-value pairs
youmind call createBoard --name "My Board" --icon.name folder --icon.color "#3B82F6"

# JSON string
youmind call createBoard '{"name":"My Board","icon":{"name":"folder","color":"#3B82F6"}}'

# Stdin JSON
echo '{"name":"My Board","icon":{"name":"folder","color":"#3B82F6"}}' | youmind call createBoard

Functional Index

Use this section as a quick task-to-CLI map.

1. Boards

Typical tasks:

• list boards
• get board details
• create a board
• update a board
• trash a board
• get default board

Discovery commands:

youmind search board

Common board APIs:

youmind info listBoards
youmind info getBoard
youmind info createBoard
youmind info updateBoard
youmind info trashBoard
youmind info getDefaultBoard

Examples:

youmind call createBoard '{"name":"My Board","icon":{"name":"folder","color":"#3B82F6"}}'
youmind call getBoard '{"id":"<board-id>"}'

Notes:

• createBoard currently requires either prompt or name plus a valid icon.

2. Notes

Typical tasks:

• create a note
• update a note
• attach note to a board

Discovery commands:

youmind search note

Known note APIs:

youmind info createNote
youmind info updateNote

Examples:

youmind call createNote '{"content":"hello"}'
youmind call createNote '{"boardId":"<board-id>","title":"My Note","content":"hello","genTitle":false}'

Notes:

• content is required.
• boardId is optional if the note should live inside a board.
• genTitle can be used for AI-generated titles.
• createNote has been verified working.

3. Materials

Typical tasks:

• add a URL as material
• inspect a material
• list materials in a board
• group or move materials
• trash or publish materials

Discovery commands:

youmind search material

Known material APIs:

youmind info createMaterialByUrl
youmind info getMaterial
youmind info listMaterials
youmind info createMaterialGroup
youmind info updateMaterialGroup
youmind info ungroupMaterialGroup
youmind info moveMaterials
youmind info trashMaterial
youmind info publishMaterial

Examples:

youmind call createMaterialByUrl '{"boardId":"<board-id>","url":"https://example.com"}'
youmind call listMaterials '{"boardId":"<board-id>"}'

Notes:

• URL material creation has been verified working.
• A newly created web material may initially appear with a status like fetching.
• listMaterials has been verified working.
• listMaterials returns a board listing model as a list of board content entities.
• No local file upload API has been discovered in the current official CLI surface. Searches for file, upload, pdf, and office did not expose a file-upload endpoint.

4. Crafts

Typical tasks:

• list crafts in a board
• inspect craft details
• publish or trash crafts
• group or move crafts

Discovery commands:

youmind search craft

Known craft APIs:

youmind info listCrafts
youmind info getCraft
youmind info publishCraft
youmind info trashCraft
youmind info createCraftGroup
youmind info updateCraftGroup
youmind info ungroupCraftGroup
youmind info moveCrafts

When handling a craft request, search first if the exact API is not already obvious.

5. Picks

Typical tasks:

• create a pick
• update a pick
• trash a pick

Discovery commands:

youmind search pick

Known pick APIs:

youmind info createPick
youmind info updatePick
youmind info trashPick

6. Documents

Typical tasks:

• create a document
• create a document from Markdown
• update a document

Discovery commands:

youmind search document

Known document APIs:

youmind info createDocument
youmind info createDocumentByMarkdown
youmind info updateDocument

Use createDocumentByMarkdown when the user already has markdown content and wants a document quickly.

7. Slides

Typical tasks:

• create slides
• update slides

Discovery commands:

youmind search slides

Known slide APIs:

youmind info createSlides
youmind info updateSlides

8. Chats

Typical tasks:

• create a chat
• send a follow-up message
• list chats
• inspect a chat
• read messages

Discovery commands:

youmind search chat
youmind search message

Known chat APIs:

youmind info createChat
youmind info sendMessage
youmind info listChats
youmind info getChat
youmind info listMessages

9. Skills

Typical tasks:

• create a skill in YouMind
• inspect a skill
• update a skill
• install a skill
• uninstall or trash a skill

Discovery commands:

youmind search skill

Known skill APIs:

youmind info createSkill
youmind info getSkill
youmind info updateSkill
youmind info installSkill
youmind info trashSkill

10. Scheduled tasks

Typical tasks:

• create a scheduled task
• update a scheduled task
• list scheduled tasks
• get a scheduled task
• trash a scheduled task

Discovery commands:

youmind search scheduled
youmind search task

Known scheduled-task APIs:

youmind info createScheduledTask
youmind info updateScheduledTask
youmind info trashScheduledTask
youmind info getScheduledTask
youmind info listScheduledTasks

11. Search and research

Typical tasks:

• semantic search across a board or library
• web search for fresh external information

Known search APIs:

youmind info search
youmind info webSearch

12. General library or unknown tasks

If the user asks for a YouMind action but the API name is unknown, start from keyword discovery.

Examples:

youmind search library
youmind search content
youmind search board
youmind search note
youmind search material
youmind search document

Then inspect with youmind info <apiName> before calling.

Recommended Operating Patterns

Safe read-first pattern

For unfamiliar or risky tasks:

youmind search <keyword>
youmind info <apiName>
youmind call <readApi> '{...}'

Only perform writes after understanding the schema.

Fast path for common operations

When the API is already known and low risk, call it directly.

Examples:

youmind call getBoard '{"id":"<board-id>"}'
youmind call createNote '{"boardId":"<board-id>","content":"..."}'
youmind call listMaterials '{"boardId":"<board-id>"}'

Destructive actions

Before operations like trashBoard, trashMaterial, trashPick, trashCraft, trashSkill, or trashScheduledTask, confirm with the user unless they were already explicit.

Authentication

Preferred local shell style:

export YOUMIND_API_KEY="sk-ym-..."

Or pass directly:

youmind --api-key "sk-ym-..." search board

Prefer environment variables in shell sessions to reduce accidental key exposure in repeated commands.

Global Options

--api-key <key>    API key
--base-url <url>   API endpoint, default https://youmind.com

OpenClaw Usage Guidance

• If the task is known and already covered by a verified API, call it directly.
• If the task is ambiguous, start with youmind search.
• Before non-trivial writes, use youmind info.
• Summarize discovered API options briefly before executing if there is any ambiguity.
• Prefer the official CLI over older wrapper implementation.
• Treat local file upload as unsupported unless the official CLI later exposes a file-upload API.