Youmind API Skill

API-first Youmind operations for local AI agents.

Core Rule

• Business operations are API-only.
• Browser automation is used only for authentication bootstrap/refresh.

Authentication

python scripts/run.py auth_manager.py status
python scripts/run.py auth_manager.py validate
python scripts/run.py auth_manager.py setup

Board APIs

# List boards
python scripts/run.py board_manager.py list

# Find boards by name/id keyword
python scripts/run.py board_manager.py find --query "roadmap"

# Get board detail
python scripts/run.py board_manager.py get --id <board-id>

# Create board
python scripts/run.py board_manager.py create --name "My Board"
python scripts/run.py board_manager.py create --name "My Board" --prompt "Initialize this board for AI coding agent research"

Material APIs

# Add link to board
python scripts/run.py material_manager.py add-link --board-id <board-id> --url "https://example.com"

# Upload local file to board
python scripts/run.py material_manager.py upload-file --board-id <board-id> --file /path/to/file.pdf

# Get snips by IDs
python scripts/run.py material_manager.py get-snips --ids "<snip-id-1>,<snip-id-2>"

# List picks (if available)
python scripts/run.py material_manager.py list-picks --board-id <board-id>

Chat APIs

# Create new chat with first message
python scripts/run.py chat_manager.py create --board-id <board-id> --message "Summarize key ideas"

# Send to existing chat
python scripts/run.py chat_manager.py send --board-id <board-id> --chat-id <chat-id> --message "Give next steps"

# Chat history/detail
python scripts/run.py chat_manager.py history --board-id <board-id>
python scripts/run.py chat_manager.py detail --chat-id <chat-id>
python scripts/run.py chat_manager.py detail-by-origin --board-id <board-id>

# Generation via chat
python scripts/run.py chat_manager.py generate-image --board-id <board-id> --prompt "Minimal blue AI poster"
python scripts/run.py chat_manager.py generate-slides --board-id <board-id> --prompt "6-page AI coding agent roadmap"

Compatibility Wrapper

python scripts/run.py ask_question.py --board-id <board-id> --question "..."
python scripts/run.py ask_question.py --board-id <board-id> --chat-id <chat-id> --question "..."

Data

Local auth state:

data/
├── auth_info.json
└── browser_state/
    └── state.json

Do not commit data/.