X Bookmarks Manager

Overview

Fetch X bookmarks via a local bird CLI install and return JSON for the agent to summarize or filter.

Workflow (agent-driven)

1. Ensure bird is installed locally via scripts/setup.sh (installs with npm into .skills-data).
2. Ensure BIRD_EXPECTED_USER is set in .skills-data/x-bookmarks-manager/.env.
3. Run scripts/x-bookmarks to validate the account and output JSON.
4. Parse or summarize the JSON for the user.

Commands

• scripts/x-bookmarks: validate bird whoami and print bird bookmarks --json.
• scripts/setup.sh: install bird in .skills-data/x-bookmarks-manager/venv/node_modules/.bin/bird and create .env.

Output

• Raw JSON from bird bookmarks --json on stdout.

Account safety

• Always run bird whoami before fetching bookmarks.
• If the active account does not match BIRD_EXPECTED_USER, stop and ask the user to fix login or update .env.

Local data and env

• Store all mutable state under /.skills-data//.
• Keep config and registries in .skills-data// (for example: config.json, .json).
• Use .skills-data//.env for SKILL_ROOT, SKILL_DATA_DIR, and any per-skill env keys.
• Install local tools into .skills-data//bin and prepend it to PATH when needed.
• Install dependencies under .skills-data//venv:
  • Python: .skills-data//venv/python
  • Node: .skills-data//venv/node_modules
  • Go: .skills-data//venv/go (modcache, gocache)
  • PHP: .skills-data//venv/php (cache, vendor)
• Write logs/cache/tmp under .skills-data//logs, .skills-data//cache, .skills-data//tmp.
• Keep automation in /scripts and read SKILL_DATA_DIR (default to /.skills-data//).
• Do not write outside and /.skills-data// unless the user requests it.

Notes

• bird is installed under .skills-data/x-bookmarks-manager/venv/node_modules/.bin/bird and invoked directly.
• Network access is required to download bird from npm on first setup.
• If bird is installed manually (npm/pnpm/bun), set BIRD_BIN in .env to the correct path.
• If bird is not authenticated, ask the user to log in with bird and retry.