@chimerai/cli

Interactive CLI wizard for ChimerAI starter kit. Quickly scaffold RBAC, authentication, chat interfaces, and more.

Installation

Global Installation

pnpm add -g @chimerai/cli

One-time Usage (npx)

npx @chimerai/cli init

Commands

chimerai init [feature]

Initialize a new ChimerAI project or add features to an existing one.

Usage:

# Interactive mode - choose features
npx @chimerai/cli init

# Initialize all features (non-interactive)
npx @chimerai/cli init --yes

# Initialize specific feature
npx @chimerai/cli init rbac
npx @chimerai/cli init auth
npx @chimerai/cli init chat

Available Features:

• rbac - Role-Based Access Control
• auth - NextAuth authentication
• chat - AI Chat interface
• billing - Subscription & billing
• rag - RAG (Retrieval Augmented Generation)
• all - All features (default)

Options:

• -d, --dir <directory> - Target directory (default: current)
• -y, --yes - Skip prompts, use defaults

chimerai add <component>

Add a specific component to your project.

Usage:

# Add users management table
npx @chimerai/cli add users-table

# Add roles management table
npx @chimerai/cli add roles-table

# Add groups management
npx @chimerai/cli add groups-table

# Add permissions management
npx @chimerai/cli add permissions-table

# Add chat UI
npx @chimerai/cli add chat-ui

Available Components:

• users-table - User management interface
• roles-table - Role management interface
• groups-table - Group management interface
• permissions-table - Permission management interface
• chat-ui - AI chat interface

chimerai setup <service>

Configure integrations and services.

Usage:

# Setup database
npx @chimerai/cli setup database

# Setup authentication
npx @chimerai/cli setup auth

# Setup OpenAI
npx @chimerai/cli setup openai

# Setup Anthropic (Claude)
npx @chimerai/cli setup anthropic

# Setup Ollama (local LLMs)
npx @chimerai/cli setup ollama

Available Services:

• database - Database connection (PostgreSQL, MySQL, SQLite)
• auth - NextAuth configuration
• openai - OpenAI API integration
• anthropic - Anthropic (Claude) API integration
• ollama - Ollama local LLM integration

chimerai examples

Show usage examples.

Examples

Complete New Project Setup

# 1. Create new Next.js project
npx create-next-app@latest my-app --typescript --tailwind --app

# 2. Navigate to project
cd my-app

# 3. Initialize ChimerAI features
npx @chimerai/cli init

# 4. Configure database
npx @chimerai/cli setup database

# 5. Configure authentication
npx @chimerai/cli setup auth

# 6. Install dependencies
pnpm install

# 7. Push database schema
pnpm db:push

# 8. Start development server
pnpm dev

Add Features to Existing Project

# Add RBAC to existing project
npx @chimerai/cli init rbac

# Add specific components
npx @chimerai/cli add users-table
npx @chimerai/cli add roles-table

# Configure AI providers
npx @chimerai/cli setup openai
npx @chimerai/cli setup anthropic

What Gets Installed

RBAC (init rbac)

• ✅ @chimerai/admin-ui package
• ✅ Prisma schema with User, Role, Permission, Group models
• ✅ API routes for CRUD operations
• ✅ Admin pages for management

Authentication (init auth)

• ✅ NextAuth configuration
• ✅ Session management
• ✅ Role & permission integration
• ✅ Protected routes middleware

Chat (init chat)

• ✅ Chat UI components
• ✅ AI provider integration
• ✅ Streaming support
• ✅ Conversation history

Billing (init billing)

• ✅ Subscription management
• ✅ Credit system
• ✅ Payment integration (Stripe)
• ✅ Usage tracking

Project Structure After Init

your-project/
├── app/
│   ├── admin/          # Admin pages
│   │   ├── users/
│   │   ├── roles/
│   │   ├── groups/
│   │   └── permissions/
│   └── api/
│       └── admin/      # Admin API routes
│           ├── users/
│           ├── roles/
│           └── groups/
├── lib/
│   ├── auth.ts         # NextAuth config
│   └── prisma.ts       # Prisma client
├── prisma/
│   └── schema.prisma   # Database schema
├── package.json        # Updated with @chimerai packages
└── .env               # Environment variables

Configuration Files

.env

After running setup commands, your .env will contain:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/db"

# Authentication
NEXTAUTH_SECRET="generated-secret"
NEXTAUTH_URL="http://localhost:3000"

# AI Providers
OPENAI_API_KEY="sk-..."
ANTHROPIC_API_KEY="sk-ant-..."
OLLAMA_API_URL="http://localhost:11434"

Development

Build CLI

cd packages/cli
pnpm build

Test Locally

# Link globally
pnpm link --global

# Test commands
chimerai init --help
chimerai add users-table

Watch Mode

pnpm dev

Troubleshooting

Command not found

If chimerai command is not found after global install:

# Reinstall globally
pnpm add -g @chimerai/cli

# Or use npx
npx @chimerai/cli

Permission errors

On Unix systems, you might need to make the CLI executable:

chmod +x ./dist/cli.js

Contributing

The CLI is extensible! Add new commands in src/commands/ and register them in src/cli.ts.

License

MIT