Pickoo
Pickoo is a complete local-first favorites workbench with a browser frontend, local Node.js server, shared task journal, and three bundled Agent Skills.
Authorization boundary
Before the first dependency installation, runtime/model download, browser login connection, or Agent Skill installation, explain the action and ask for user approval. Ordinary capture may access only the links the user submitted and the configured Pickoo library.
Read docs/PERMISSIONS.md before setup or any operation involving browser state, local Agent folders, media downloads, OCR, ASR, or private sessions.
Start
- Confirm Node.js 20+ and Python 3.10+ are available.
- In this Skill directory, install Node dependencies with
npm cionly after approval. - Install Python dependencies from
skill-source/creator-content-ingest/requirements.txtonly when capture is requested and after approval. - Start with
npm startand openhttp://127.0.0.1:4324. - Let the user choose a library in settings, or use
PICKOO_LIBRARY_ROOT. Never infer a personal Obsidian or another project's path.
Runtime data lives outside this package. On macOS it defaults to ~/Library/Application Support/Pickoo; settings default to ~/.config/pickoo/settings.json; the content library defaults to ~/Documents/Pickoo Library.
Save links
Use the bundled intake entry point:
python3 skill-source/save-to-favorites/scripts/save_link.py submit --wait --input '<complete share text>' --source-agent '<agent>' --input-channel agent-direct
The intake wrapper owns duplicate detection and handoff to creator-content-ingest. Do not create a second intake task through another capture Skill.
Respect platform access controls. Do not bypass login, membership, DRM, regional, signature, or rate limits. Report partial and failed states honestly.