yoniergomez/ai-locker repository overview

⁠AI Locker — AI Prompts Manager

A beautiful, self-hosted web app to manage your AI prompts, skills, steering configurations, MCP server setups, and shell commands. Includes built-in AI Chat to generate library items from natural language.

Built with a true-black glassmorphism design and multi-provider AI support (OpenAI, Anthropic, Google Gemini, Amazon Bedrock, OpenRouter).

🔗 GitHub⁠ · Live Demo⁠

⁠Quick Start

⁠SQLite (simplest — no external DB)

docker run -d \
  --name ai-locker \
  -p 9090:3001 \
  -v ai_locker_data:/data \
  --restart unless-stopped \
  yoniergomez/ai-locker:latest

Open http://localhost:9090⁠

⁠Docker Compose + PostgreSQL (recommended)

curl -O https://raw.githubusercontent.com/YonierGomez/ai-locker/main/compose.yaml
docker compose up -d

Open http://localhost:9090⁠

services:
  app:
    image: yoniergomez/ai-locker:latest
    container_name: ai-locker
    ports:
      - "9090:3001"
    environment:
      NODE_ENV: production
      PORT: 3001
      DB_HOST: postgres-db
      DB_PORT: 5432
      DB_NAME: promptly
      DB_USER: promptly
      DB_PASSWORD: secret
      DB_TYPE: postgres
    volumes:
      - ai_locker_data:/data
    restart: unless-stopped
    depends_on:
      postgres-db:
        condition: service_healthy

  postgres-db:
    image: postgres:alpine
    container_name: ai-locker-postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: promptly
      POSTGRES_USER: promptly
      POSTGRES_PASSWORD: secret
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U promptly -d promptly"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  ai_locker_data:
  postgres_data:

⁠External PostgreSQL (connection string)

docker run -d \
  --name ai-locker \
  -p 9090:3001 \
  -v ai_locker_data:/data \
  -e DATABASE_URL=postgresql://user:pass@host:5432/dbname \
  --restart unless-stopped \
  yoniergomez/ai-locker:latest

⁠Environment Variables

⁠Supported Architectures

amd64 · arm64 · armv7

⁠Features

• 📝 Prompts — templates with categories, models, temperature, token limits
• ⚡ Skills — reusable AI behavior definitions with trigger phrases
• 🧭 Steering — system instructions with scope and priority
• 🔌 MCP Configs — Model Context Protocol server configurations
• 💻 Commands — shell command library with usage tracking
• 🤖 AI Chat — multi-provider (OpenAI, Anthropic, Gemini, Bedrock, OpenRouter)
• 📊 Dashboard — activity heatmap, usage charts, model distribution
• ☁️ S3 Backup — AWS S3 / Cloudflare R2 / Backblaze B2 / MinIO
• 📝 Notes — Post-it Wall, Board, Grid, Timeline and List views
• 🗑️ Trash — soft delete with auto-purge and restore

⁠Useful Commands

# View logs
docker compose logs -f

# Update to latest
docker compose pull && docker compose up -d

# Backup SQLite
docker cp ai-locker:/data/prompts.db ./backup-$(date +%Y%m%d).db

# Backup PostgreSQL
docker exec ai-locker-postgres pg_dump -U promptly promptly > backup-$(date +%Y%m%d).sql

⁠Links

• 📦 GitHub Repository⁠
• 🐛 Issues⁠
• ❤️ Sponsor⁠