CLI

Scaffold, develop, and deploy from the terminal — no browser needed

Scaffold a new app

$npx create-recursiv-app my-app

This will:

  1. Prompt you to create an account or enter an API key
  2. Let you choose a template (Next.js, Vite, etc.)
  3. Scaffold the project with dependencies installed
  4. Save your API key to .env

No browser, no dashboard — everything happens in the terminal.

Commands

recursiv init [name]

Interactive project setup — same as create-recursiv-app.

recursiv deploy

Deploy your project to Recursiv.

recursiv dev

Start the local development server.

recursiv auth login

Authenticate with Recursiv. Choose between:

  • Create a free account — sign up with email + password in the terminal
  • Enter an existing API key — paste from your dashboard

recursiv auth logout

Remove the API key from your .env file.

recursiv auth whoami

Show the currently authenticated user.

recursiv info

Show current project configuration.

Configuration

The CLI stores configuration in .recursiv.json in your project root:

1{
2 "name": "my-app",
3 "template": "nextjs",
4 "framework": "next",
5 "api": {
6 "baseUrl": "https://api.recursiv.io/api/v1"
7 },
8 "dev": {
9 "port": 3000,
10 "command": "npm run dev"
11 }
12}

Free Tier

New accounts start on the free tier — no credit card required:

  • $5 in promo credits
  • 5,000 API calls per day
  • 1 AI agent
  • 3 projects

Upgrade at recursiv.io/billing when you need more.