KITT

AI-powered monorepo CLI for Railway deployments.

  ______ _______________________
  ___  //_/___  /__  __/__  __/
  __  ,<   __  / __  /  __  /
  _  /| | __/ /  _  /   _  /
  /_/ |_| /___/  /_/    /_/

KITT scaffolds full-stack monorepos, adds apps with integrations pre-wired, and manages deployment to Railway — all from a persistent REPL shell.

Install

npm install -g openkitt

Or run without installing:

npx openkitt

Requirements

• Node.js ≥ 20
• Railway CLI installed and authenticated
• An LLM provider: Anthropic, OpenAI, Gemini, or GitHub Copilot

Quick Start

kitt > /auth:login          # Authenticate Railway + LLM
kitt > /kitt:init            # Create a new workspace
kitt [my-project] > /app:create    # Add an app (framework + integrations)
kitt [my-project] > /deploy:app    # Deploy to Railway

Commands

Auth

| Command | Description | |---|---| | /auth:login | Full auth setup — Railway + LLM | | /auth:railway | Authenticate with Railway | | /auth:llm | Configure LLM provider and API key | | /auth:model | Switch active model | | /auth:status | Show current auth status | | /auth:logout | Remove all stored credentials |

Workspace

| Command | Description | |---|---| | /kitt:init | Scaffold a new workspace and create/link a Railway project | | /kitt:delete [name] | Delete a workspace and all its files | | /kitt:switch [name] | Switch active workspace | | /kitt:list | List all reachable workspaces | | /kitt:status | Workspace overview and Railway links | | /kitt:link [projectId] | Link an existing Railway project (or create a new one) |

Apps

| Command | Description | |---|---| | /app:create | Add a new app (framework + integrations) | | /app:delete [appName] | Remove an app and its files | | /app:list | List all apps, packages, and services | | /app:run [appName] | Start an app's dev server | | /app:settings | View or update workspace settings |

Deploy & Infrastructure

| Command | Description | |---|---| | /deploy:app [appName] | Deploy an app to Railway (includes .env secret scanning) | | /deploy:template <query> | Search and provision a Railway template | | /deploy:delete [service] | Delete a Railway service only (keeps local app files) | | /deploy:destroy | Delete entire Railway project (irreversible, requires confirmation) | | /deploy:domain [appName] | Generate a domain or show the existing domain | | /deploy:logs [appName] | View recent deployment logs | | /deploy:status | Workspace/apps/services status + recent deployments | | /deploy:health [appName] | HTTP health check on deployed services | | /env:create <name> | Create a new Railway environment | | /env:delete <name> | Delete a Railway environment | | /env:vars [service] | List environment variables for a service | | /env:vars set [svc] <k> <v> | Set an environment variable |

[!WARNING] /deploy:destroy, /kitt:delete, /app:delete, and /env:delete are destructive. Use carefully. In non-interactive mode, pass --yes for state-changing commands.

Version Management

| Command | Description | |---|---| | /versions:list | View all pinned integration versions | | /versions:check | Check for newer available versions | | /versions:update | Interactive version update wizard | | /versions:set <name> <ver> | Pin a specific version |

Frameworks

| Type | Options | |---|---| | Full-stack | tanstack-start, nextjs | | Backend | hono, expressjs |

Integrations

| Category | Options | |---|---| | Databases | postgresql, mysql, sqlite | | ORM | drizzle, prisma | | Auth | better-auth | | Payments | stripe, polar | | Email | resend | | Queues | bullmq, trigger-dev | | Cache | redis | | UI | tailwindcss, shadcn | | Analytics | posthog, sentry | | Testing | vitest, playwright, storybook |

CLI Flags

--verbose              Enable verbose logging
-q, --quiet            Suppress non-essential output
--run <command>        Execute a single command and exit
--dry-run              Preview changes without applying
-y, --yes              Auto-confirm all prompts
--config <json>        Pass command selections as JSON
--env <name>           Target a specific Railway environment
--no-update-check      Skip version check on startup
--debug                Show LLM timing and token usage
-v, --version          Print CLI version
-h, --help             Print help

Non-interactive mode

npx openkitt --run "deploy:app my-app" --yes --env production

State-changing commands (for example: /kitt:init, /app:create, /deploy:app, /deploy:destroy, /env:create, /env:delete, /env:vars set) require --yes in --run mode.

License

MIT