stash

stash is a powerful tool that transforms saved Instagram posts into easily retrievable notes through an automated process. Rather than merely bookmarking content, stash transcribes saved posts and organizes them into a structured format, ensuring that relevant information is accessible when needed. This project enhances productivity by delivering insights at the right moment, tailored to individual workflows without requiring manual intervention.

Key Features

• Automatic Transcription: Converts Instagram posts into notes without user input once set up.
• Smart Processing: Organizes saved content into markdown format with YAML frontmatter for streamlined access and use.
• Integration with Claude and MCP: Works seamlessly with artificial intelligence retrieval systems, allowing for quick and efficient access to your notes.

Architecture Overview

The core of stash operates through a sophisticated pipeline as illustrated below:

share sheet ─┐
             ├─► /ingest ─► queue ─► fetch ─► transcribe ─► frame gate ─► extract ─► vault/*.md + FTS5
data export ─┘

Usage Examples

Utilize stash effectively with the following commands:

.venv/bin/python -m stash add "https://www.instagram.com/reel/..." -n "why I saved it"
.venv/bin/python -m stash process
.venv/bin/python -m stash search "agent memory"
.venv/bin/python -m stash status

Capture from Your Phone

Stash includes a capture mechanism that allows saving posts from mobile devices, featuring:

1. Cloudflare Worker: Manages requests separately from your main device, ensuring that captures are independent.
2. iOS Shortcut: Integrates with your phone to queue submissions to the Worker.
3. Daemon on Mac: Processes submissions remotely, allowing continuous operation.

Advanced Features

• Data Backfilling: Existing saved posts can be imported through a detailed JSON export from Instagram.
• Hybrid Search Functionality: Combines exact match search and semantic search methods to ensure comprehensive retrieval of notes.

Efficient Management

Regular checks and feedback loops are built into stash, ensuring efficient operation and reliability:

• stash doctor verifies the environment and dependencies.
• Regularly utilize status checks on the daemon to ensure operational integrity.

With stash, turn your saved Instagram content into a valuable knowledge repository effortlessly, streamlining access and enhancing personal productivity.