aircrushin/promptMinder
aircrushin/promptMinder has 117 GitHub stars and 55 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 19:27 UTC. Last push 2026-11-09.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
一个开源的,专注于提示词管理的平台 / An open-source platform focused on prompt management
AIREADME_EN.md
OriginalPromptMinder
A professional prompt management platform that makes AI prompt management simpler and more efficient

🌟 Features
Core Functions
- ✅ Prompt Version Management - Support for version history and rollback
- ✅ Version Diff Comparison - Git-like side-by-side diff view to quickly identify prompt changes
- ✅ Version Approval Workflow - Team workspaces support configurable approval flow (submit/approve/reject/withdraw)
- ✅ Review Thread with @Mentions - Change-request-level comments with
@team membermentions - ✅ Change Subscription & Notification Center - Subscribe to prompt changes and receive in-app notifications
- ✅ Tag Management - Custom tags for quick categorization and retrieval
- ✅ Public/Private Mode - Support for private prompts and public sharing
- ✅ AI Smart Generation - Integrated AI models for generating quality prompts
- ✅ Team Collaboration - Team creation, member management, and role-based permissions
- ✅ Prompt Contributions - Community contribution features with review and publishing process
- ✅ Agent Skills Catalog - Browse synced public skills, install them, or add them to your workspace
- ✅ Conversation method extraction - Turn chats into goals, methods, variables, and corrections; review before private save
- ✅ Skill export - Export prompts as local Skill ZIPs; catalog entries include synced text files and source metadata
User Experience
- 📱 Mobile Responsive - Responsive design, perfect support for mobile devices
- 🌍 Internationalization - Support for Chinese and English
- 🎨 Modern Interface - Beautiful design based on Shadcn UI
- 🌙 Dark Mode - Light, dark, and system appearance with saved preferences and cross-tab synchronization; theme guide and screenshots
- 🔍 Smart Search - Quick search and filtering functionality
- 📋 One-Click Copy - Convenient copy and share functions
Technical Features
- ⚡ High Performance - Next.js 16 + React 19, lightning-fast loading
- 🔐 Secure Authentication - Enterprise-grade user authentication with Clerk
- 💾 Reliable Storage - Neon PostgreSQL + Drizzle ORM
- 🚀 Easy Deployment - Support for one-click deployment with Vercel and Zeabur
🚀 Quick Start
Requirements
- Node.js 20.0 or higher
- pnpm 11.x (matches
packageManagerinpackage.json; project scripts usepnpm) - Git
Local Development
- Clone the project
git clone https://github.com/aircrushin/promptMinder.git
cd promptMinder
- Install dependencies
# recommend using pnpm
pnpm install
- Configure environment variables
Create a
.env.localfile and configure the following variables:
See .env.example at the repo root for the full list. For local development, configure at least:
# Clerk
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/prompts
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/prompts
# Database (Neon PostgreSQL)
DATABASE_URL=postgresql://user:[email protected]/neondb?sslmode=require
# Supabase (file storage)
SUPABASE_URL=
SUPABASE_ANON_KEY=
# AI (Zhipu for generation/import; OpenAI-compatible defaults for Playground)
ZHIPU_API_KEY=
ZHIPUAI_API_KEY=
OPENAI_COMPAT_API_KEY=
OPENAI_COMPAT_URL=https://api.openai.com/v1
# Admin (comma-separated, optional)
[email protected]
# App URL
NEXT_PUBLIC_BASE_URL=http://localhost:3000
# Skills catalog sync (`pnpm skills:sync`)
SKILLS_SH_TOKEN=
GITHUB_TOKEN=
# CLI / agents (optional)
PROMPTMINDER_TOKEN=pm_xxx
Configure social login (e.g. GitHub) in the Clerk dashboard; you do not need separate GitHub App env vars in .env.local.
Run database migrations
After pulling the latest code, run migrations before starting the app (required for workflow tables/columns):
pnpm db:migrate
Sync the first batch of official Skills (requires SKILLS_SH_TOKEN, or compatible VERCEL_OIDC_TOKEN):
pnpm skills:sync
By default this syncs the first 50 curated skills. Full content is stored only for sources with a clear redistributable license and acceptable security status; other sources keep index metadata and attribution. Use --limit=0 to sync all curated items, or add --all for the full catalog.
- Start the development server
pnpm dev
Visit http://localhost:3000 to view the application.
CLI Quick Start
Regular users do not need any admin script to get started. Create a token in the web app:
https://www.prompt-minder.com/settings/cli-tokens
Then install and use the CLI (Node.js ≥ 20):
npm i -g @aircrushin/promptminder-cli
promptminder auth login --token pm_xxx
promptminder team list
Update with npm i -g @aircrushin/promptminder-cli@latest. As of 2026-09-24, npm’s latest is 0.1.3; this repo’s workspace CLI is 0.2.0 with skill list/get/import/update/install, not yet published—see CLI package docs.
Scripts and agents can use export PROMPTMINDER_TOKEN=pm_xxx instead of local login. Auth precedence: --token → PROMPTMINDER_TOKEN → saved config; a stale env var overrides a newly saved token.
CLI Agent Skill
If you want AI agents like Cursor, Claude Code, or Codex CLI to properly use PromptMinder CLI, install the standalone skill repository first:
npx skills add aircrushin/promptminder-cli-skill
npx skills list
Use skills list to verify installation; skills find searches the registry and does not validate local installs.
Repository: https://github.com/aircrushin/promptminder-cli-skill
The CLI still retains promptminder skills install as a deprecated compatibility entry for legacy installations. Future updates will focus on the standalone skill repository.
Common Development Commands
pnpm lint # Run ESLint
pnpm test # Run Jest tests
pnpm test:coverage # Generate a coverage report
pnpm analyze # Analyze build output size
pnpm cli:agent -- prompt.list
📦 Deployment Guide
Vercel Deployment
Preparation
- Fork this project to your GitHub account
- Register and log in to Vercel
Deployment Steps
- Click
New Projectin Vercel - Select
Import Git Repository - Choose your forked project
- Configure environment variables (see environment variables description above)
- Click
Deploy
- Click
Automatic Deployment
- After deployment, each push to the main branch will automatically redeploy
Zeabur Deployment
Visit Zeabur and log in
Create a new project and connect your GitHub repository
Configure environment variables
Deploy and get the access address
🗃 Database Configuration
Neon PostgreSQL + Drizzle ORM
This project uses Neon Serverless PostgreSQL as the database and Drizzle ORM for database queries and schema management.
Create a Neon database
- Register for a Neon account
- Create a new project and get the
DATABASE_URLconnection string - Add the connection string to
DATABASE_URLin.env.local
Initialize database schema
# Push Drizzle schema to the database (first time or development)
pnpm db:push
- Database commands
pnpm db:push # Push schema to database (recommended for development)
pnpm db:generate # Generate SQL migration files
pnpm db:migrate # Run migration files (recommended for production)
pnpm db:studio # Open Drizzle Studio for visual database management
Schema and migration files
The project currently uses
drizzle.config.mjsand thedrizzle/directory for migration execution, while keeping initialization and supplemental SQL scripts insql/:drizzle/migrate.js— migration entry scriptdrizzle/— Drizzle migration-related filessql/teams.sql— team and membership tablessql/prompts.sql— core prompt and version datasql/tags.sql— tag-related tablessql/project.sql— project organization tablessql/contributions.sql— community contribution and review flow
🔄 Team Workflow Notes
- Team managers can enable/disable the version approval workflow in Team Management.
- Existing teams are default
OFF; newly created teams are defaultON. - When enabled, new prompts and edits are submitted as change requests instead of being published directly.
- Approval permissions:
owner/admin; review threads support@mentions. - Prompt-level subscriptions and the Notification Center are available for in-app updates.
🧩 Agent Skills Catalog
PromptMinder includes a Skills catalog at /skills for discovering, reviewing, and reusing public Agent Skills.
What it supports
- Browse: Paginated catalog with search by name, description, or source
- Sort: By install count (most popular) or recently synced
- Detail pages: Source, license, install count, Markdown body, and supporting files
- Install methods: Command / Prompt snippets aligned with skills.sh, with one-click copy
- Add to workspace: Signed-in users can add available content as a prompt and continue editing in the library
- Content policy: Full content is hosted only for clearly redistributable, acceptable sources; other entries keep index metadata and link back to the original repository
Syncing data
Sync the catalog from public sources with:
pnpm skills:sync
Defaults to the first 50 curated skills. Use --limit=0 for all curated items, or --all for the full catalog. Set SKILLS_SH_TOKEN (or VERCEL_OIDC_TOKEN) before syncing.
Relationship to the CLI Skill
- Site Skills catalog: Browse public/community skills and optionally add them to a PromptMinder workspace
- PromptMinder CLI Skill: Teaches AI agents how to use the PromptMinder CLI (see “CLI Agent Skill” above)
They complement each other and are not substitutes.
🔐 Authentication Configuration
Clerk Setup
Create a Clerk application
- Visit Clerk
- Create a new application
- Select authentication methods (email, social login, etc.)
Configure OAuth providers
- Enable GitHub, Google, and other login methods in the Clerk console
- Configure callback URLs
Get keys
- Copy the Publishable Key and Secret Key
- Add them to your environment variables
For detailed configuration, refer to the Clerk official documentation
🌍 Internationalization
The project supports multiple languages, currently:
- 🇨🇳 Simplified Chinese
- 🇺🇸 English
Language files are located in the /messages directory:
zh.json- Chinese translationsen.json- English translations
Adding a new language
- Create a new language file in the
/messagesdirectory - Copy the structure of an existing translation file
- Add support for the new language in
LanguageContext
🛠 Development Guide
Project Structure
promptMinder/
├── app/ # Next.js App Router pages and APIs
├── components/ # React components (including ui/prompt/team, etc.)
├── contexts/ # React Context
├── hooks/ # Custom Hooks
├── lib/ # Utilities, auth, team context, and business logic
├── messages/ # Localization messages
├── drizzle/ # Drizzle migration scripts
├── sql/ # Initialization / supplemental SQL scripts
├── packages/ # Subpackages such as the CLI
├── docs/ # Project documentation
└── public/ # Static assets
Code Standards
- Use ESLint for code checking
- Follow React Hooks best practices
- The project is JavaScript-first and uses
jsconfig.jsonfor the@/path alias - CSS uses Tailwind CSS
Contribution Guidelines
- Fork this project
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Create a Pull Request
🤝 Community
User Feedback
Use Canny to collect user feedback and feature requests.
- Register for a Canny account and create a project
- Get the Canny URL
- Configure the link in the application's Footer component
📄 License
This project is licensed under the MIT License.
💖 Support the Project
If this project has been helpful to you, welcome to:
- ⭐ Star the project
- 🍴 Fork and improve
- 🐛 Submit bug reports
- 💡 Suggest new features
PromptMinder - Making AI prompt management simpler ✨