Sheshiyer Social Intake Orchestrator
Overview
Pulls saved/bookmarked content from Twitter/X and Instagram, enriches it with AI-generated summaries, topic tags, and Enneagram resonance analysis, then routes each item into the correct PARA vault folder as a fully-formed Obsidian markdown note.
Pipeline Stages
- FETCH — Pull new bookmarks from bird-cli and gram-cli
- NORMALIZE — Convert platform-specific JSON to unified SocialItem schema
- DEDUPE — SHA-256 hash check against registry to skip already-ingested items
- ENRICH — AI analysis: summary, topic tags, Enneagram type, PARA folder recommendation
- ROUTE — Map to correct PARA vault folder with fallback to Social-Inbox
- WRITE — Create Obsidian .md file with frontmatter, insert MOC backlinks
- STATUS — Write pipeline.json for status/monitoring
Trigger
Invoke this skill when:
- User asks to "ingest bookmarks", "sync social saves", "pull bookmarks"
- Scheduled task fires on your chosen daily cadence
- User clicks "Hunt" in the monitoring applet
Execution
Run the orchestrator:
bun <skills-dir>/social-intake-orchestrator/lib/orchestrator.ts
The orchestrator chains all pipeline stages sequentially, writes status updates at each stage, and reports results.
Configuration
- Vault path:
<VAULT>/(set to your vault root) - Hash registry:
{vault}/.social-intake-hashes.json(gitignored) - Cursor store:
<STATE_DIR>/cursors.json - Pipeline status:
<STATE_DIR>/pipeline.json - Auth: bird uses Firefox profile extraction, gram uses
~/.config/gram/config.json5
Auth Prerequisites
Before running, verify both CLIs are authenticated:
bird check # Should show ✅ auth_token and ✅ ct0
gram check # Should show "OK Credentials valid"
Manual Invocation
To run a single ingestion cycle manually:
# Full pipeline
bun <skills-dir>/social-intake-orchestrator/lib/orchestrator.ts
# With fetch limit
FETCH_LIMIT=10 bun <skills-dir>/social-intake-orchestrator/lib/orchestrator.ts