CLI Commands

Complete reference for all RealmKit CLI commands. Use these commands to create projects, discover templates, publish realms, and manage your RealmKit workflow.

Quick Reference

Most commonly used commands to get you started

Create a project
realmkit create saas-starter my-app
List available realms
realmkit list --popular
Search for realms
realmkit search "next.js"
Get help
realmkit help create

Project Management

Commands for creating and managing RealmKit projects

realmkit create
Popular

Create a new project from a realm template

realmkit create <realm-name> [project-name] [options]
Examples
realmkit create saas-starter my-app
realmkit create next-blog --typescript
realmkit create vue-admin my-dashboard --git
Options
--gitInitialize git repository
--typescriptUse TypeScript variant if available
--installAuto-install dependencies (default: true)
--no-installSkip dependency installation
realmkit init

Initialize RealmKit in an existing project

realmkit init [options]
Examples
realmkit init
realmkit init --force
Options
--forceOverwrite existing configuration

Realm Discovery

Commands for finding and exploring realm templates

realmkit list
Popular

List available realm templates

realmkit list [category] [options]
Examples
realmkit list
realmkit list saas
realmkit list --popular
realmkit list --author=realmkit
Options
--popularShow only popular realms
--recentShow recently updated realms
--author=<name>Filter by author
--limit=<number>Limit number of results
realmkit search
Popular

Search for realms by name, description, or tags

realmkit search <query> [options]
Examples
realmkit search "next.js"
realmkit search authentication --category=saas
realmkit search --tag=typescript
Options
--category=<cat>Filter by category
--tag=<tag>Filter by tag
--fuzzyEnable fuzzy matching
realmkit info

Show detailed information about a realm

realmkit info <realm-name>
Examples
realmkit info saas-starter
realmkit info next-blog --json
Options
--jsonOutput in JSON format

Publishing & Management

Commands for publishing and managing your own realms

realmkit publish

Publish a realm template to the registry

realmkit publish [path] [options]
Examples
realmkit publish
realmkit publish ./my-realm --public
realmkit publish --draft
Options
--publicMake realm publicly visible
--privateKeep realm private
--draftPublish as draft
--forceForce publish with warnings
realmkit update

Update an existing published realm

realmkit update <realm-name> [options]
Examples
realmkit update my-realm
realmkit update my-realm --version=1.2.0
Options
--version=<ver>Set specific version
--patchIncrement patch version
--minorIncrement minor version
--majorIncrement major version
realmkit unpublish

Remove a realm from the registry

realmkit unpublish <realm-name> [version]
Examples
realmkit unpublish my-realm
realmkit unpublish my-realm 1.0.0
Options
--forceSkip confirmation prompt

Configuration

Commands for managing RealmKit configuration

realmkit config
Popular

Manage RealmKit configuration settings

realmkit config <action> [key] [value]
Examples
realmkit config list
realmkit config get apiKey
realmkit config set defaultCategory saas
realmkit config unset apiKey
Options
--globalUse global configuration
--localUse project configuration
realmkit login

Authenticate with RealmKit registry

realmkit login [options]
Examples
realmkit login
realmkit login --token=<api-key>
Options
--token=<key>Login with API key
realmkit logout

Sign out from RealmKit registry

realmkit logout
Examples
realmkit logout
realmkit whoami

Show current authenticated user

realmkit whoami
Examples
realmkit whoami

Utilities

Helper commands and utilities

realmkit version

Show RealmKit CLI version information

realmkit version [options]
Examples
realmkit version
realmkit version --json
Options
--jsonOutput in JSON format
realmkit help

Display help information

realmkit help [command]
Examples
realmkit help
realmkit help create
realmkit help search
realmkit doctor

Diagnose common issues and verify setup

realmkit doctor
Examples
realmkit doctor
Options
--fixAttempt to fix issues automatically
realmkit cache

Manage local cache

realmkit cache <action>
Examples
realmkit cache clear
realmkit cache info
realmkit cache clean

Global Options

Options that work with all RealmKit commands

--verbose, -vEnable verbose output
--quiet, -qSuppress non-error output
--help, -hShow help for command
--versionShow version number
--config=<path>Use custom config file
--no-colorDisable colored output

Common Patterns

Typical workflows and command combinations

Starting a New Project

# Search for a suitable realm
realmkit search "saas" --tag=typescript

# Get details about a realm
realmkit info saas-starter

# Create your project
realmkit create saas-starter my-startup

# Navigate and start developing
cd my-startup
npm run dev

Publishing Your First Realm

# Login to RealmKit
realmkit login

# Initialize realm in your project
realmkit init

# Publish as draft first
realmkit publish --draft

# Make it public when ready
realmkit update my-realm --public

Configuration Setup

# Set up your preferences
realmkit config set defaultCategory saas
realmkit config set authorName "Your Name"
realmkit config set authorEmail "you@example.com"

# View current configuration
realmkit config list

Troubleshooting

Common issues and their solutions

Command not found

If you get "realmkit: command not found", the CLI might not be installed or not in your PATH.

npm install -g @realmkit/cli
Permission denied

Authentication required for this operation. Make sure you're logged in.

realmkit login
Network issues

If commands are timing out, check your internet connection and try again.

realmkit doctor