Command-line tools for the VoltX framework. Scaffold projects, run the dev server, build for production, and generate code.

Installation

npm install -g @voltx/cli

Or use directly with npx:

npx @voltx/cli dev

Commands

Development

voltx dev          # Start dev server with hot reload
voltx build        # Build for production
voltx start        # Start production server

Create a New Project

voltx create my-app
voltx create my-app --template chatbot
voltx create my-app --template rag-app
voltx create my-app --template agent-app

For the full interactive experience with tool selection, RAG toggle, and API key management, use npx create-voltx-app instead.

Code Generation

voltx generate route api/users      # New API route
voltx generate agent assistant       # New agent definition
voltx generate tool search           # New tool for agents
voltx generate job cleanup           # New background job

Templates

| Template | What you get | Frontend UI | |----------|-------------|-------------| | blank | Minimal server with file-based routing | — | | chatbot | Streaming chat + memory | Chat interface | | rag-app | Document Q&A + vector search | Ingest + query split view | | agent-app | AI agent with calculator + datetime tools | Chat with tool steps |

All non-blank templates include a public/index.html with a dark-theme Tailwind CSS UI that connects to the backend API routes.

Programmatic Usage

import { createProject } from "@voltx/cli";

await createProject({
  name: "my-app",
  template: "chatbot",
  auth: "jwt",
});

Part of VoltX

This package is part of the VoltX framework. See the monorepo for full documentation.

License

MIT — Made by the Promptly AI Team