@lizard-build/cli 0.3.88 → 0.3.90

package/README.md

@@ -1,6 +1,14 @@
 # Lizard CLI
 
-Deploy and manage apps on [Lizard](https://lizard.build).
+Deploy apps, databases and sandboxes to Lizard (lizard.build) from the command line.
+
+Point the CLI at your code and it detects the stack — Node, Python, Go, Rust,
+Ruby, PHP or Java — builds it and ships it live. Managed Postgres, Managed Redis
+and Managed Object Storage attach in one command. Billing only for active
+resources, so idle apps cost a fraction.
+
+Every command is agent-readable: add `--json` for structured output, or run
+`lizard --help --json` to dump the full command schema.
 
 ## Install
 
@@ -14,6 +22,17 @@ Or via npm:
 npm i -g @lizard-build/cli
 ```
 
+## Start here (AI agents)
+
+```bash
+lizard skills get core
+```
+
+Skills ship inside the CLI, so the guide always matches the installed version.
+They cover the whole app lifecycle — deploy, link, addons, logs, scaling,
+secrets, domains — with copy-paste examples. Prefer this over guessing commands
+from flag docs alone.
+
 ## Usage
 
 ```bash
@@ -22,20 +41,53 @@ lizard init
 lizard up
 ```
 
+`lizard up` uploads the code, builds it and returns a live URL on onlizard.com.
+Add managed data services in one command:
+
+```bash
+lizard add postgres redis s3
+```
+
 ## Common commands
 
 ```
 lizard up         # upload and deploy code
-lizard logs       # stream runtime logs
+lizard add        # add Managed Postgres, Managed Redis or Managed Object Storage
 lizard ps         # list services
-lizard add        # add a database or service
-lizard secrets    # manage secrets
+lizard logs       # stream runtime logs
+lizard metrics    # resource metrics (CPU, memory, network, disk) and cost
 lizard scale      # scale replicas / CPU / memory
+lizard secrets    # manage secrets
 lizard domain     # manage domains
+lizard run        # run a command with project and service secrets injected
+lizard ssh        # open a shell in a service
+lizard sandbox    # create and manage Sandboxes
+lizard volume     # Persistent Volumes for Sandboxes
+lizard skills     # agent guides, version-matched to the CLI
 ```
 
 Run `lizard --help` for the full list.
 
+## For agents and scripts
+
+Add `--json` to any command for structured output. The CLI also switches to JSON
+on its own when stdout is not a TTY. Errors come back as
+`{"error": {"code", "status", "message", "body"}}` and exit codes are stable:
+
+```
+0  success          3  not found (404)
+1  generic error    4  timeout (408/504)
+2  auth (401/403)   5  cancelled by user
+```
+
+`lizard --help --json` dumps the machine-readable schema for any command —
+arguments, options, defaults, subcommands and exit codes.
+
+## Links
+
+- Docs — https://lizard.build/docs
+- Source — https://github.com/lizard-build/lizard-cli
+
 ## License
 
 MIT

package/dist/commands/docs.js

@@ -1,6 +1,9 @@
 import open from "open";
 import { success, isJSONMode, printJSON } from "../lib/format.js";
-const DOCS_URL = "https://docs.lizard.build";
+// Docs are served from the main host under /docs. The docs.lizard.build
+// subdomain resolves but has no valid certificate, so opening it dumps the
+// user on a TLS error page — don't switch back to it without checking.
+const DOCS_URL = "https://lizard.build/docs";
 export function registerDocs(program) {
     program
         .command("docs")

package/dist/commands/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElE,MAAM,QAAQ,GAAG,2BAA2B,CAAC;AAE7C,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,oEAAoE;QACpE,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,SAAS,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,OAAO,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElE,wEAAwE;AACxE,2EAA2E;AAC3E,uEAAuE;AACvE,MAAM,QAAQ,GAAG,2BAA2B,CAAC;AAE7C,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,oEAAoE;QACpE,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,SAAS,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,OAAO,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/lib/updater.d.ts

@@ -1,4 +1,4 @@
-export declare const CURRENT_VERSION = "0.3.88";
+export declare const CURRENT_VERSION = "0.3.90";
 /**
  * True only when running as the Bun-compiled standalone binary. Under
  * npm/node, `process.execPath` is the *node* executable — self-update would

package/dist/lib/updater.js

@@ -4,7 +4,7 @@ import { Readable } from "node:stream";
 import { join, dirname } from "node:path";
 import os from "node:os";
 import { spawn } from "node:child_process";
-export const CURRENT_VERSION = "0.3.88";
+export const CURRENT_VERSION = "0.3.90";
 const RELEASES_API = "https://api.github.com/repos/lizard-build/lizard-cli/releases/latest";
 const RELEASE_BASE = "https://github.com/lizard-build/lizard-cli/releases/latest/download";
 /** Minimum gap between background update checks. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lizard-build/cli",
-  "version": "0.3.88",
-  "description": "Lizard CLI — deploy and manage apps on Lizard",
+  "version": "0.3.90",
+  "description": "Lizard CLI — deploy apps, databases and sandboxes to Lizard (lizard.build) from your terminal or your coding agent. Detects Node, Python, Go, Rust, Ruby, PHP and Java; adds Managed Postgres, Managed Redis and Managed Object Storage in one command.",
   "type": "module",
   "bin": {
     "lizard": "./dist/index.js"
@@ -22,7 +22,18 @@
   "keywords": [
     "cli",
     "deploy",
+    "deployment",
     "paas",
+    "hosting",
+    "containers",
+    "kubernetes",
+    "postgres",
+    "redis",
+    "s3",
+    "sandbox",
+    "ai-agent",
+    "coding-agent",
+    "devops",
     "lizard"
   ],
   "repository": {

package/src/commands/docs.ts

@@ -2,7 +2,10 @@ import { Command } from "commander";
 import open from "open";
 import { success, isJSONMode, printJSON } from "../lib/format.js";
 
-const DOCS_URL = "https://docs.lizard.build";
+// Docs are served from the main host under /docs. The docs.lizard.build
+// subdomain resolves but has no valid certificate, so opening it dumps the
+// user on a TLS error page — don't switch back to it without checking.
+const DOCS_URL = "https://lizard.build/docs";
 
 export function registerDocs(program: Command) {
   program

package/src/lib/updater.ts

@@ -5,7 +5,7 @@ import { join, dirname } from "node:path";
 import os from "node:os";
 import { spawn } from "node:child_process";
 
-export const CURRENT_VERSION = "0.3.88";
+export const CURRENT_VERSION = "0.3.90";
 const RELEASES_API = "https://api.github.com/repos/lizard-build/lizard-cli/releases/latest";
 const RELEASE_BASE = "https://github.com/lizard-build/lizard-cli/releases/latest/download";
 

package/test/unit/json.test.ts

@@ -286,7 +286,9 @@ describe("docs --json", () => {
     const { stdout, exitCode } = await run(["docs", "--json"]);
     expect(exitCode).toBe(0);
     const out = parseJSON(stdout);
-    expect(out.url).toContain("docs.lizard.build");
+    // Pin the exact URL: this assertion previously matched a substring and
+    // happily passed against docs.lizard.build, which serves no valid cert.
+    expect(out.url).toBe("https://lizard.build/docs");
     expect(out.opened).toBe(false);
   });
 });