CLI Reference

The luluclaw CLI lets you manage your AI assistants entirely from the terminal. Install it with npm and you are ready to go.

Installation

Requires Node.js 18 or later.

bash

npm install -g luluclaw

Or run without installing:

bash

npx luluclaw help

Authentication

Interactive login

Run luluclaw login to authenticate interactively. Your session is stored at ~/.luluclaw/config.json with 0600 file permissions and auto-refreshes silently.

CI/CD and automation

For non-interactive environments, use environment variables or flags:

bash

# Environment variables
export LULUCLAW_TOKEN="your-session-token"
export LULUCLAW_TENANT="your-tenant-id"
export LULUCLAW_AGENT="your-agent-id"
luluclaw deploy

# Or inline flags
luluclaw deploy --token "..." --tenant "..." --agent "..."

Auth

luluclaw signupalias: register

Opens luluclaw.com/sign-up in your browser.

bash

luluclaw signup

luluclaw loginalias: auth

Interactive sign-in. Prompts for email, tenant ID, and password.

bash

luluclaw login

Setup

luluclaw setupalias: onboard

Guided wizard to create and deploy a new bot. Walks through channel selection, model choice, and deployment.

bash

luluclaw setup

luluclaw agentsalias: bots, list

List all agents in your workspace with their status. If you have multiple agents, select which one to use as the default.

bash

luluclaw agents

Operations

luluclaw start

Start your active bot.

bash

luluclaw start

luluclaw stop

Stop your active bot.

bash

luluclaw stop

luluclaw restart

Restart your active bot. Use after deploying workspace changes.

bash

luluclaw restart

luluclaw statusalias: whoami

Show workspace and session status including plan, agent, and connection info.

bash

luluclaw status

luluclaw logsalias: log

Tail your bot's runtime logs.

bash

luluclaw logs              # last 80 lines
luluclaw logs --lines 200  # last 200 lines
luluclaw logs --stderr     # stderr stream

Development

luluclaw deployalias: push

Push local .md files to your bot's workspace. Reads all markdown files from the current directory (or a specified path) and uploads them.

bash

luluclaw deploy            # push .md files from current directory
luluclaw deploy ./docs     # push from a specific directory

luluclaw chat

Interactive terminal chat with your bot. Messages stream in real-time via SSE.

bash

luluclaw chat
# Type messages, press Enter to send
# /quit to exit

luluclaw config

View or edit your bot's customization (system prompt).

bash

luluclaw config              # show current config
luluclaw config show         # same as above
luluclaw config set-prompt   # open editor to write new system prompt

luluclaw exportalias: download

Download your bot's entire workspace as a ZIP file.

bash

luluclaw export                       # saves as agent-workspace.zip
luluclaw export -o my-backup.zip      # custom filename

Utility

luluclaw upgradealias: update

Check for and install the latest version of the CLI from npm.

bash

luluclaw upgrade

luluclaw help

Show the help screen with all available commands.

bash

luluclaw help

Configuration

The CLI stores its state at ~/.luluclaw/config.json. This file has 0600 permissions (owner read/write only) and contains your session token, tenant ID, active agent ID, and credentials for silent token refresh.

You can safely delete this file to reset all CLI state. Run luluclaw login to re-authenticate.