🔐 Locksmith CLI

> Seamlessly add authentication infrastructure to AI applications


Locksmith is a powerful CLI tool that helps developers quickly integrate enterprise-grade authentication into their AI applications. It supports modern auth providers, generates secure configurations, and integrates with popular LLM tools for seamless development.

✨ Features

- 🚀 Quick Setup - Interactive wizard for authentication provider setup
- 🔧 Multiple Providers - ScaleKit, Auth0, FusionAuth support
- 🤖 LLM Integration - Generate code with Claude, Gemini, or Cursor Agent
- 📦 Auth Modules - Full-stack auth, SSO, and MCP (Model Context Protocol)
- 🔒 Secure Storage - Encrypted credential management
- 🎯 Developer Friendly - Interactive and programmatic modes

📋 Table of Contents

- Installation
- Quick Start
- Commands
- Authentication Providers
- LLM Brokers
- Configuration
- Examples
- Roadmap
- Contributing
- License

🚀 Installation

$3

- Node.js 16+ and npm/pnpm
- Access to authentication provider (ScaleKit recommended)

$3

``bash
npm install -g locksmith-cli


or


pnpm add -g locksmith-cli
`

$3

`bash
locksmith --version
locksmith --help
`

⚡ Quick Start

1. Initialize your project:

`bash
locksmith init
`

2. Configure LLM broker:

`bash
locksmith configure llm
`

3. Add authentication modules:

`bash
locksmith add
`

4. Generate configurations:
`bash
locksmith generate
`

📖 Commands

$3

Initialize authentication in your project with an interactive setup wizard.

`bash


Interactive setup (recommended)

locksmith init

Non-interactive setup (ScaleKit only)

locksmith init --provider=scalekit --environment-id=your-env-id --client-id=your-client-id --client-secret=your-secret --environment-url=https://your-env.scalekit.cloud
`

Flags:

- --provider, -p - Authentication provider (scalekit, auth0, fusionauth)
- --environment-id, -e - ScaleKit environment ID
- --client-id, -c - ScaleKit client ID
- --client-secret, -s - ScaleKit client secret
- --environment-url, -u - ScaleKit environment URL
- --interactive, -i - Force interactive mode
- --no-interactive, -I - Skip interactive prompts

$3

Configure authentication settings, LLM brokers, and preferences.

`bash


Configure LLM broker

locksmith configure llm --broker=claude

Configure authentication provider

locksmith configure auth --provider=scalekit

Interactive configuration

locksmith configure
`

Subcommands:

- llm - Configure preferred LLM broker (claude, gemini, cursor-agent)
- auth - Configure authentication provider settings

Flags:

- --broker, -b - LLM broker (claude, gemini, cursor-agent)
- --provider, -p - Authentication provider
- --interactive, -i - Force interactive mode

$3

Add authentication providers and modules to your project.

`bash


Interactive module selection

locksmith add

Add specific module

locksmith add --module=full-stack-auth

Add multiple modules

locksmith add --module=full-stack-auth --module=sso
`

Available Modules:

- full-stack-auth - Complete authentication system
- sso - Enterprise SSO integration
- mcp - Model Context Protocol authentication

Flags:

- --module - Authentication module to add
- --interactive, -i - Force interactive mode

$3

Generate secure authentication configurations and integrate with LLM tools.

`bash


Generate with all configured modules

locksmith generate

Generate specific module

locksmith generate --module=full-stack-auth

Save prompt for review

locksmith generate --prompt-out=./prompt.txt
`

Flags:

- --module - Specific module to generate
- --prompt-out - Save generation prompt to file
- --verbose, -v - Show detailed output
- --dry-run, -d - Show what would be done

$3

- --help, -h - Show help message
- --version, -v - Show version number
- --verbose, -v - Enable verbose output
- --dry-run, -d - Show what would be done without making changes
- --force, -f - Skip confirmation prompts
- --interactive, -i - Force interactive mode
- --no-interactive, -I - Skip interactive prompts

🔐 Authentication Providers

$3

Enterprise-grade authentication for AI applications with full support for:

- SSO and multi-tenant authentication
- Custom auth flows
- Production-ready security

Setup:

`bash
locksmith init --provider=scalekit
`

$3

Support for Auth0 and FusionAuth is planned for future releases.

🤖 LLM Brokers

Locksmith integrates with popular LLM tools to generate authentication code:

$3

`bash
locksmith configure llm --broker=claude
locksmith generate --module=full-stack-auth
`

$3

`bash
locksmith configure llm --broker=gemini
locksmith generate --module=sso
`

$3

`bash
locksmith configure llm --broker=cursor-agent
locksmith generate --module=mcp
`

⚙️ Configuration

$3

Credentials are securely stored in ~/.locksmith/credentials.json:

`json
{
"provider": "scalekit",
"environmentId": "your-env-id",
"clientId": "your-client-id",
"clientSecret": "your-client-secret",
"environmentUrl": "https://your-env.scalekit.cloud"
}
`

$3

- ~/.locksmith/credentials.json - Authentication credentials
- ~/.locksmith/config.json - CLI preferences and settings
- ~/.locksmith/llm-brokers.json - LLM broker configurations

💡 Examples

$3

`bash


1. Initialize with ScaleKit

locksmith init

2. Configure Claude as LLM broker

locksmith configure llm --broker=claude

3. Add authentication modules

locksmith add --module=full-stack-auth --module=sso

4. Generate configurations

locksmith generate
`

$3

`bash


Non-interactive setup for CI

locksmith init \
--provider=scalekit \
--environment-id=$SCALEKIT_ENV_ID \
--client-id=$SCALEKIT_CLIENT_ID \
--client-secret=$SCALEKIT_CLIENT_SECRET \
--environment-url=$SCALEKIT_ENV_URL \
--no-interactive

Generate configs in CI

locksmith generate
`

$3

`bash


Quick setup for development

locksmith init --interactive

Generate and review prompt

locksmith generate --prompt-out=./auth-prompt.txt --dry-run

Generate with verbose output

locksmith generate --verbose --module=full-stack-auth
`

🗺️ Roadmap

$3

- ScaleKit authentication provider integration
- Interactive CLI setup wizard
- LLM broker integration (Claude, Gemini, Cursor Agent)
- Multiple authentication modules
- Secure credential management

$3

- Auth0 provider integration
- FusionAuth provider integration
- Advanced SSO configurations

$3

- Docker container support
- Web dashboard for configuration
- Plugin system for custom providers
- Multi-environment support
- Audit logging
- Backup/restore functionality

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

$3

`bash


Clone the repository

git clone https://github.com/Saif-Shines/locksmith.git
cd locksmith

Install dependencies

pnpm install

Run in development

pnpm start --help

Run tests

pnpm test
``

$3

- 🐛 Bug Reports
- 💡 Feature Requests
- 📖 Documentation Issues

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

- ScaleKit for enterprise authentication infrastructure
- Anthropic Claude for AI-powered code generation
- Google Gemini for intelligent assistance
- Cursor for the Agent integration

📞 Support

- 📧 Email: saif@saifshines.dev
- 🐙 GitHub Issues: Create an issue
- 📖 Documentation: saifshines.dev/notes/locksmith-cli/

---

Made with ❤️ by Saif Ali Shaik