Pull a blueprint
April 18, 2026 · View on GitHub
LynxPrompt
Self-hostable AI config management for teams and individuals
What is LynxPrompt?
LynxPrompt is a self-hostable platform for managing AI IDE configuration files — AGENTS.md, .cursor/rules/, CLAUDE.md, slash commands, and 30+ other formats. Deploy it on your own infrastructure and give your team a central hub to create, share, and standardize AI coding assistant configurations across every project.
Instead of manually writing configuration files for every project and every AI tool, use LynxPrompt to:
- Generate configs through an interactive wizard (web or CLI)
- Share blueprints through a private or federated marketplace
- Standardize AI behavior across projects with reusable templates
- Export to any supported format with one click
LynxPrompt is free and open-source. Self-host it for personal use, or deploy it within your organization to enforce coding standards, share institutional knowledge, and ensure consistent AI assistant behavior across your engineering teams. A hosted instance is also available at lynxprompt.com for those who prefer not to self-host.
Key Features
Universal AI Config Hub
Supports 30+ AI coding assistants — Cursor, Claude Code, GitHub Copilot, Windsurf, Zed, Aider, Gemini CLI, Cline, Roo Code, Amazon Q, JetBrains Junie, and many more. Write once, export to any format.
Blueprint Marketplace
Internal or federated marketplace for sharing AI configurations and slash commands within your organization. Browse, search, favorite, and reuse blueprints across teams.
Interactive Wizard
Step-by-step config generator available on both web and CLI. Auto-detects your tech stack, frameworks, and repo structure from GitHub/GitLab URLs. Supports template variables, monorepo hierarchies, and draft auto-saving.
Configurable Authentication
Flexible auth to fit your environment:
- OAuth — GitHub, Google
- Email — Passwordless magic link login
- Passkeys — WebAuthn biometric/hardware key authentication
- SSO — SAML, OIDC, and LDAP for enterprise identity providers
Optional AI-Powered Editing
Enable AI-assisted blueprint creation and editing with your own Anthropic API key. Entirely optional — works fully without it.
Full REST API + CLI Tool
Programmatic access for automation and CI/CD integration. Generate API tokens, fetch blueprints, search, and download via REST. The CLI (lynxp) mirrors the full web platform feature set.
Self-Hostable with Docker Compose
Single docker compose up to run the entire stack. PostgreSQL included. Auto-runs database migrations on startup. Toggle every feature via environment variables.
Quick Start (Self-Hosting)
# 1. Create a .env file
cat > .env <<EOF
NEXTAUTH_SECRET=$(openssl rand -base64 32)
ADMIN_EMAIL=your@email.com
APP_URL=http://localhost:3000
EOF
# 2. Download the self-host compose file and start LynxPrompt
curl -O https://raw.githubusercontent.com/GeiserX/LynxPrompt/main/docker-compose.selfhost.yml
docker compose -f docker-compose.selfhost.yml up -d
# 3. Open http://localhost:3000
That's it. LynxPrompt is running with PostgreSQL, automatic migrations, and email authentication enabled by default.
Helm Chart (Kubernetes)
A Helm chart is also available for Kubernetes deployments. See the chart documentation for the full values reference.
helm repo add lynxprompt https://geiserx.github.io/LynxPrompt
helm install lynxprompt lynxprompt/lynxprompt
Configuration
All features are controlled via environment variables. Toggle what you need, disable what you don't.
| Variable | Default | Description |
|---|---|---|
NEXTAUTH_SECRET | (required) | Session encryption key |
APP_URL | http://localhost:3000 | Base URL of your instance |
APP_NAME | LynxPrompt | Instance name shown in the UI |
ENABLE_GITHUB_OAUTH | false | GitHub OAuth login |
ENABLE_GOOGLE_OAUTH | false | Google OAuth login |
ENABLE_EMAIL_AUTH | true | Magic link email login |
ENABLE_PASSKEYS | true | WebAuthn passkey authentication |
ENABLE_TURNSTILE | false | Cloudflare Turnstile CAPTCHA |
ENABLE_SSO | false | SAML / OIDC / LDAP authentication |
ENABLE_USER_REGISTRATION | true | Allow public sign-ups |
ENABLE_AI | false | AI-powered editing features |
AI_MODEL | claude-3-5-haiku-latest | AI model for editing |
ANTHROPIC_API_KEY | Required when ENABLE_AI=true | |
ENABLE_BLOG | false | Blog module |
ENABLE_SUPPORT_FORUM | false | Support forum module |
ENABLE_STRIPE | false | Stripe payments for marketplace |
SUPERADMIN_EMAIL | Auto-promote this email to superadmin | |
APP_LOGO_URL | Custom logo URL | |
UMAMI_SCRIPT_URL | Umami analytics script URL | |
CONTACT_EMAIL | Contact form destination | |
STATUS_PAGE_URL | Status page link |
CLI
The CLI tool mirrors the web platform and works against any LynxPrompt instance. By default it connects to lynxprompt.com, but you can point it to any self-hosted deployment.
# Install
npm install -g lynxprompt
# (Optional) Point to a self-hosted instance — two ways:
lynxp config set-url https://lynxprompt.your-company.com
# or: export LYNXPROMPT_API_URL=https://lynxprompt.your-company.com
# Authenticate (opens browser on the configured instance)
lynxp login
# Generate AI config files interactively
lynxp wizard
# Pull a blueprint
lynxp pull bp_abc123
# Push local configs
lynxp push
# View current CLI configuration
lynxp config
The API URL is stored in the CLI config file (see lynxp config path). The LYNXPROMPT_API_URL environment variable takes precedence if set.
Also available via Homebrew (brew install GeiserX/lynxprompt/lynxprompt) and Chocolatey (choco install lynxprompt).
VS Code Extension
Prefer managing configs without leaving the editor? LynxPrompt also has an official VS Code extension.
From inside VS Code you can:
- Browse your cloud blueprints and local AI config files in a dedicated sidebar
- Pull
AGENTS.md,CLAUDE.md,.cursor/rules/, and more into the correct workspace paths - Diff local files against their cloud versions with the built-in editor
- Push updates back to LynxPrompt without leaving VS Code
Install it from the Marketplace or run ext install LynxPrompt.lynxprompt.
Architecture
- Frontend + API: Next.js 16 with App Router
- Database: PostgreSQL with Prisma ORM
- Deployment: Docker Compose with auto-migration on startup
- Auth: NextAuth.js with configurable providers
- Search: Full-text search via PostgreSQL
Supports single-database or multi-database setups depending on your scale requirements.
Development
git clone https://github.com/GeiserX/LynxPrompt.git
cd LynxPrompt
cp env.example .env
docker compose up -d
npm install --legacy-peer-deps
npm run dev
See CONTRIBUTING.md for contribution guidelines.
Documentation
Full documentation is available at lynxprompt.com/docs, covering:
- Getting Started
- Configuration Wizard
- Blueprints & Commands
- CLI Reference
- API Reference
- Self-Hosting Guide
Ecosystem
| Project | Type | Description |
|---|---|---|
| lynxprompt-mcp | MCP Server | Browse and manage blueprints from AI assistants via the Model Context Protocol |
| lynxprompt-vscode | VS Code Extension | Pull, diff, and push AI config files without leaving the editor |
| homebrew-lynxprompt | Homebrew Tap | Install the LynxPrompt CLI on macOS/Linux via brew install GeiserX/lynxprompt/lynxprompt |
| n8n-nodes-lynxprompt | n8n Community Node | Automate blueprint workflows in n8n |
License
This project is licensed under the GNU General Public License v3.0.
Author: Sergio Fernández Rubio (GeiserX)