Weblisk CLI

Zero-dependency static site builder, AI code generator, and hub operations client.

A standalone Go binary. No runtime, no package manager, no dependencies. The CLI scaffolds projects, serves them locally, builds for production, dispatches to the user's AI model for code generation, and provides operator-authenticated operations against a running orchestrator.

Related Projects

Repository	Description
weblisk	Core framework — the client-side JS runtime
weblisk-templates	Project templates used by weblisk new
weblisk-blueprints	Agent, domain, gateway, and server blueprints

Install

macOS / Linux (recommended):

curl -fsSL https://cdn.weblisk.dev/install.sh | sh

Windows (PowerShell):

irm https://cdn.weblisk.dev/install.ps1 | iex

Go install:

go install github.com/avaropoint/weblisk-cli@latest

Download binary — grab the latest release for your platform:

Platform	Binary
macOS (Apple Silicon)	weblisk-darwin-arm64
macOS (Intel)	weblisk-darwin-amd64
Linux (x64)	weblisk-linux-amd64
Linux (ARM64)	weblisk-linux-arm64
Windows (x64)	weblisk-windows-amd64.exe

Build from source:

git clone https://github.com/avaropoint/weblisk-cli.git
cd weblisk-cli
make build

Usage

# Create a new project
weblisk new my-site
weblisk new my-blog --template blog
weblisk new my-app --template dashboard --local

# Start dev server
cd my-site && weblisk dev

# Build for production
weblisk build --minify --fingerprint

# Add framework files to an existing project
weblisk vendor
weblisk vendor --dest js/vendor

# Code generation (requires an AI provider — local is fine)
export WL_AI_PROVIDER=claude-code          # or: ollama, local-cli, openai, anthropic
weblisk server init             # Generate orchestrator
weblisk agent create seo        # Generate SEO agent
weblisk domain create billing   # Generate domain controller
weblisk gateway create          # Generate application gateway
weblisk pattern apply cqrs      # Apply cross-cutting pattern

# Start the system
weblisk server start
weblisk agent start seo --orch http://localhost:9800
weblisk domain start billing
weblisk gateway start

# Operator identity
weblisk operator init
weblisk operator register --orch http://localhost:9800

# Marketplace
weblisk marketplace activate --key WL-XXXX-XXXX-XXXX-XXXX
weblisk marketplace list

# Operations (requires operator registration)
weblisk status
weblisk agents
weblisk workflows
weblisk approvals
weblisk audit --since 1h

Templates

Project templates are sourced from weblisk-templates. The CLI resolves templates from multiple sources in priority order:

1. Local — ./templates/ in your project directory
2. Custom — repos listed in WL_TEMPLATE_SOURCES
3. Core — weblisk-templates (always present)

Add custom template sources via .env:

WL_TEMPLATE_SOURCES=https://github.com/your-org/your-templates.git

Blueprints

Agent, domain, gateway, and server blueprints are sourced from weblisk-blueprints. See that repository for the full specification and available blueprints.

The CLI resolves blueprints from multiple sources in priority order:

1. Local — ./blueprints/ in your project directory
2. Custom — repos listed in WL_BLUEPRINT_SOURCES
3. Core — weblisk-blueprints (always present)

Add custom blueprint sources via .env:

WL_BLUEPRINT_SOURCES=https://github.com/your-org/your-blueprints.git

Environment Variables

Variable	Description	Default
WL_ORIGIN	Production origin URL	http://localhost:3000
WL_PORT	Dev server port	3000
WL_DIST	Output directory	dist
WL_CDN	CDN base URL (rewrites importmaps on build)	—
WL_LIB	Local framework path	lib/weblisk
WL_ORCH	Orchestrator URL	http://localhost:9800
WL_TEMPLATE_SOURCES	Additional template repo URLs (comma-separated)	—
WL_BLUEPRINT_SOURCES	Additional blueprint repo URLs (comma-separated)	—
WL_AI_PROVIDER	AI backend — see below	openai
WL_AI_MODEL	Model name	provider default
WL_AI_BASE_URL	Endpoint override (HTTP providers)	—
WL_AI_KEY	API key (hosted providers only)	—
WL_AI_COMMAND	Path to a local CLI (claude-code, local-cli)	auto-detected
WL_AI_ARGS	Extra flags for local-cli, quotes honoured	—
WL_AI_JSON	1 if the local-cli tool prints a JSON result envelope	—
WL_AI_TIMEOUT	Per-call limit for local CLIs, e.g. 20m	10m

AI providers

Generating a hub from blueprints needs a model. It does not need a paid account — three of the five backends run entirely on the machine.

Local — no key, nothing to configure:

WL_AI_PROVIDER	Requires	Notes
claude-code	Claude Code installed	Uses the CLI's own login. Auto-detected on PATH and in ~/.local/bin, ~/.claude/local, Homebrew and npm prefixes
ollama	Ollama running	Defaults to http://localhost:11434/v1; set WL_AI_MODEL
local-cli	any local tool	Set WL_AI_COMMAND; pass flags with WL_AI_ARGS

Hosted — requires WL_AI_KEY: openai, anthropic, cloudflare, or any OpenAI-compatible endpoint via WL_AI_BASE_URL.

# Generate a hub with a locally installed Claude Code — no API key
export WL_AI_PROVIDER=claude-code
weblisk server init --platform go

# Or entirely offline with Ollama
export WL_AI_PROVIDER=ollama WL_AI_MODEL=deepseek-coder-v2
weblisk server init --platform go

# Or any other local tool
export WL_AI_PROVIDER=local-cli
export WL_AI_COMMAND=/usr/local/bin/mytool
export WL_AI_ARGS='--print --format json'

If a local CLI is installed and still reports as missing, it is almost certainly $PATH. A process started by launchd, systemd, an editor or a double-click does not inherit a login shell's PATH, and these tools install to directories that are only on PATH because a shell profile puts them there. The resolver searches the usual install locations for exactly this reason; set WL_AI_COMMAND to the full path if it still cannot find yours.

Operator Identity

The operator command manages ML-DSA-65 key-based identity for authenticating with a running orchestrator's admin API:

weblisk operator init                    # Generate key pair (~/.weblisk/keys/)
weblisk operator register --orch <url>   # Register with orchestrator
weblisk operator token                   # Show current token

Once registered, all operations commands (status, agents, workflows, etc.) authenticate automatically using the stored token.

Marketplace

The marketplace replaces the old single-key licensing model. Each product has its own license key, and multiple products can be activated simultaneously:

weblisk marketplace activate --key WL-XXXX-XXXX-XXXX-XXXX
weblisk marketplace list
weblisk marketplace remove <product>
weblisk marketplace update

Activated products are stored in ~/.weblisk/marketplace.json. Modules are downloaded from cdn.weblisk.dev/marketplace/.

Releasing

git tag v1.2.0
git push origin v1.2.0

The release workflow cross-compiles for all platforms and creates a GitHub Release.

License

MIT