CLI Reference

The Weblisk CLI is a single standalone binary — no runtime, no package manager, no dependencies.

Commands

weblisk new

Create a new project:

weblisk new my-app
weblisk new my-app --local
weblisk new my-blog --template blog
weblisk new my-dashboard --template dashboard
weblisk new my-docs --template docs
weblisk new my-site --template starter

| Flag | Description |

|------|-------------|

| --template | Use a starter template (blog, dashboard, docs) |

| --local | Include framework files locally instead of CDN |

| --lib <path> | Custom path for local framework files |

weblisk dev [root]

Start a development server with live reload:

weblisk dev
weblisk dev --port 3000

| Flag | Description |

|------|-------------|

| --port <number> | Port to serve on (default: 5500 or WL_PORT) |

weblisk build [root]

Build a production-ready static site:

weblisk build
weblisk build --minify
weblisk build --fingerprint
weblisk build --minify --fingerprint

The build copies your project to dist/ as-is. Opt-in optimizations:

| Flag | What it does |

|------|-------------|

| --minify | Minifies HTML, CSS, and JavaScript |

| --fingerprint | Hashes asset filenames for cache busting |

No composition, no transformation — what you write is what ships. The build only copies files and optionally optimizes them.

Output directory: dist/ (configure via WL_DIST in .env)

weblisk vendor

Download all framework modules from the CDN into your project for local use:

weblisk vendor
weblisk vendor --dest src/lib/weblisk

Downloads all 52 framework modules into lib/weblisk/ (default) or a custom path. Update your import map to point at the local files instead of the CDN.

| Flag | Description |

|------|-------------|

| --dest <path> | Destination directory (default: lib/weblisk) |

weblisk server

Manage the AI agent orchestration server:

weblisk server init      # Initialize server configuration
weblisk server start     # Start the agent server
weblisk server verify    # Verify server health
weblisk server status    # Check server status

weblisk agent

Manage AI agents:

weblisk agent create    # Create a new agent
weblisk agent start     # Start an agent
weblisk agent verify    # Verify agent health
weblisk agent list      # List running agents

weblisk domain

Manage domain controllers — business logic directors that orchestrate agents:

weblisk domain create seo --platform go     # Generate a domain controller
weblisk domain start seo                   # Start a domain controller

weblisk gateway

Manage application gateways — end-user edge security with session auth, ABAC, and rate limiting:

weblisk gateway create --platform go     # Generate an application gateway
weblisk gateway start                    # Start the gateway

weblisk blueprints

Manage blueprint specifications:

weblisk blueprints list     # List all resolved blueprints
weblisk blueprints update   # Update cached blueprints from all sources

weblisk validate

Validate all blueprints against their schemas:

weblisk validate          # Validate all blueprints in the project

Reports compliance level per blueprint: Certified, Compliant, Partial, Draft, or Rejected.

weblisk status

Check hub status — server, agents, gateway, and domain controllers:

weblisk status               # Current hub status
weblisk status --watch       # Continuous monitoring
weblisk status --json        # Machine-readable output

weblisk generate

Generate code from blueprint declarations (used with the starter template):

weblisk generate             # Generate site from YAML declarations

weblisk license

Activate or manage a Pro license:

weblisk license --key YOUR_KEY --domain example.com
weblisk pro --key YOUR_KEY        # alias for license

| Flag | Description |

|------|-------------|

| --key <key> | Your Pro license key |

| --domain <domain> | Domain to activate for |

weblisk update

Re-download the latest framework files and Pro modules (if licensed).

weblisk version

Print the CLI version.

weblisk help

Show available commands and usage.

Configuration

.env

WL_ORIGIN=http://localhost:5500   # Base URL
WL_PORT=5500                       # Dev server port
WL_DIST=dist                       # Build output directory
WL_AI_PROVIDER=openai              # AI provider for agents
WL_AI_MODEL=gpt-4o                 # AI model name
WL_AI_KEY=sk-...                   # AI API key
WL_TEMPLATE_SOURCES=owner/repo     # Custom template repositories
WL_BLUEPRINT_SOURCES=owner/repo    # Custom blueprint repositories

Roadmap

Upcoming CLI capabilities, grouped by development tier: