drumsergio/lynxprompt repository overview

⁠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)
[email protected]
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.

⁠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

⁠License

This project is licensed under the GNU General Public License v3.0⁠.

Author: Sergio Fernández Rubio (GeiserX⁠)