MindPocket

A fully open-source, free, multi-platform, one-click deployable personal bookmark system with AI Agent integration.

中文文档

📸 More Screenshots

Web	AI Chat	Mobile

MindPocket organizes your bookmarks with AI-powered RAG content summarization and automatic tag generation, making it easy to find and manage your saved content.

✨ Features

1. Zero Cost: Vercel + Neon free tier is enough for personal use
2. One-Click Deploy: Set up your personal bookmark system in minutes
3. Multi-Platform: Web + Mobile + Browser Extension
4. AI Enhanced: RAG and AI Agent for smart tagging and summarization
5. Open Source: Fully open source, your data belongs to you

🎨 VIBE CODING

This is a pure VIBE CODING project:

• I only implemented one core feature, the rest was built by Claude Code
• 26,256 lines of pure code, see Code Insight
• VIBE Coding experience summary: Development Experience
• VIBE Coding write-up (CN): How I VIBE CODED this project
• VIBE Coding PRs are welcome!!!

🚀 Quick Deploy

Prerequisites

• Vercel Account (Free)
• A PostgreSQL database
• LLM and Embedding Model API Key

Deploy Steps

1. Fork this repository

2. Connect to Vercel

   • Click "New Project" → "Import Git Repository" in Vercel dashboard
   • Select your forked MindPocket repository
   • Set Root Directory to apps/web
   • Keep Build Command as pnpm build
   • Click "Deploy"
   • Add a PostgreSQL DATABASE_URL in "Settings" → "Environment Variables"
   • Neon pooled URLs work out of the box if you want a managed option
   • Connect Vercel Blob storage
   • Add the remaining environment variables in "Settings" → "Environment Variables" (refer to apps/web/.env.example)

3. Initialize Database

   • No manual action required
   • During build, the app runs an idempotent bootstrap (CREATE EXTENSION IF NOT EXISTS vector + drizzle-kit push --force)

4. Create Admin Account

   • Visit your deployment URL
   • Register your first account to start using

💻 Local Development

Requirements

• Node.js 18+
• pnpm 10.9.0

Installation

# Clone repository
git clone https://github.com/yourusername/mindpocket.git
cd mindpocket

# Install dependencies
pnpm install

# Start local PostgreSQL 18 with pgvector
docker compose up -d postgres

# Configure environment
cd apps/web
cp .env.example .env.local
# Edit .env.local with your configuration if needed

# Initialize database
pnpm db:bootstrap

# Start development server
cd ../..
pnpm dev

Visit http://127.0.0.1:3000 to start using.

Local Database

MindPocket expects a standard PostgreSQL DATABASE_URL. For local development, the repository includes a Docker Compose service that starts PostgreSQL 18 with pgvector enabled.

docker compose up -d postgres

Default local connection:

DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:5432/mindpocket

If pnpm db:bootstrap fails, check these first:

• Docker PostgreSQL is running
• Port 5432 is free
• DATABASE_URL points to the local container
• The container image includes pgvector

Commands

# Root
pnpm dev          # Start all apps
pnpm build        # Build all apps
pnpm cli:build    # Build the CLI package
pnpm cli:pack     # Preview the npm package contents for the CLI
pnpm format       # Format code
pnpm check        # Code check

# Web (apps/web)
pnpm dev          # Start Next.js
pnpm db:studio    # Database UI
pnpm db:generate  # Generate migrations
pnpm db:migrate   # Run migrations
pnpm db:push      # Push schema directly

# Native (apps/native)
pnpm dev          # Start Expo
pnpm android      # Run on Android
pnpm ios          # Run on iOS

CLI

MindPocket CLI is the official command line client for agents, scripts, and developers who want to interact with a MindPocket server from the terminal.

Install

npm install -g mindpocket

Or with pnpm:

pnpm add -g mindpocket

Quick Start

mindpocket --help
mindpocket config set server https://your-domain.com
mindpocket auth login
mindpocket user me
mindpocket bookmarks list

Upgrade

npm install -g mindpocket@latest

Uninstall

npm uninstall -g mindpocket

Help for AI Agents

Each command includes structured --help output so an AI agent can inspect:

• what the command does
• required arguments and options
• whether login is required
• output JSON fields
• examples
• common error codes

Examples:

mindpocket --help
mindpocket auth --help
mindpocket bookmarks create --help

CLI Release

The npm package is published automatically from GitHub Actions when a tag matching cli-vX.Y.Z is pushed.

Examples:

git tag cli-v1.0.0
git push origin cli-v1.0.0

GitHub repository secrets must include:

• NPM_TOKEN

🛠 Tech Stack

Category	Technologies
Web	Next.js 16, Radix UI, Tailwind CSS 4, Better Auth, Drizzle ORM, Vercel AI SDK, Zustand
Mobile	Expo, React Native, Expo Router
Extension	WXT, Vite
Tooling	Turborepo, pnpm, Biome, Ultracite

📱 Supported Platforms

• ✅ Web Application
• ✅ iOS / Android Mobile App
• ✅ Browser Extension (Chrome / Firefox / Edge)

🚧 Roadmap

• More UI settings options
• Support more bookmark platforms
• Improve AI Agent experience
• Optimize RAG

See todolist for detailed roadmap.

🤝 Contributing

Contributions are welcome! Feel free to submit issues, share VIBE Coding experiences, or open pull requests.

QQ Group: 682827415 | Join

📄 License

MIT License - see LICENSE

🙏 Acknowledgments

Thanks to Claude Code for its significant contribution to this project!