@caffeineai/cli 0.1.0-dev.0

package/LICENSE

@@ -0,0 +1 @@
+© Caffeine Labs AG. All rights reserved. Use is subject to the Caffeine AI [Terms of Use](https://caffeine.ai/terms-of-use)

package/README.md

@@ -0,0 +1,95 @@
+# @caffeineai/cli
+
+Command-line interface for the Caffeine platform.
+
+## Development Release
+
+This is a DEV release. It is published under the npm `dev` dist-tag and is subject to a rapid release cadence. Expect frequent updates while the CLI and MCP packages settle.
+
+## Installation
+
+```bash
+npm install -g @caffeineai/cli@dev
+```
+
+Three equivalent command names are installed: `caffeine`, `caf`, and `cfn`.
+
+```bash
+caffeine --version
+```
+
+## Quick Start
+
+```bash
+caffeine auth login            # Sign in
+caffeine projects list         # List your Caffeine projects
+caffeine projects clone <id>   # Clone one locally
+caffeine build                 # Build the current project
+caffeine preview               # Upload a draft to Caffeine cloud
+```
+
+## Supported Platforms
+
+Native binaries ship for:
+
+- macOS arm64 and x64
+- Linux arm64 and x64, glibc and musl
+- Windows arm64 and x64
+
+## Commands
+
+| Group | Command | Description |
+| --- | --- | --- |
+| Auth | `auth login [--device]` | Sign in via OAuth loopback or device flow |
+| Auth | `auth logout` | Sign out |
+| Auth | `auth status` | Show current session |
+| Projects | `projects list` | List your projects |
+| Projects | `projects show <id>` | Show project details |
+| Projects | `projects create <name>` | Create a new project |
+| Projects | `projects clone <id> [--dest <path>] [--include-wip]` | Clone a project locally |
+| Projects | `projects delete <id>` | Delete a project |
+| Local | `import` | Import a project from a .zip |
+| Local | `export` | Export the current project to a .zip |
+| Build | `install` | Install build dependencies |
+| Build | `build` | Build the current project |
+| Build | `check` | Validate code and configuration |
+| Build | `preview` | Upload a built project as a draft |
+| Config | `config list` / `get <key>` / `set <key> <value>` | Manage CLI config |
+| Env | `doctor [--fix]` | Diagnose local build prerequisites |
+| Meta | `update` | Check for or install a newer CLI |
+| Meta | `version` | Show version info |
+
+Run `caffeine <command> --help` for the full flag list.
+
+## JSON And Non-Interactive Mode
+
+Every command accepts `--json`. JSON output uses a stable envelope:
+
+```json
+{ "ok": true, "data": {} }
+{ "ok": false, "error": { "code": "...", "message": "..." } }
+```
+
+Use `--non-interactive` in scripts and CI.
+
+## Authentication
+
+`caffeine auth login` opens your browser for an OAuth flow. For CI or remote SSH, add `--device` to use the device flow instead.
+
+Tokens are stored in your OS credential store. The `@caffeineai/mcp` server reads the same credentials, so one login covers both packages.
+
+## MCP Server
+
+Drive Caffeine from Claude Code, Cursor, VS Code, Codex, Windsurf, or another MCP host with the companion MCP server:
+
+```bash
+npx -y @caffeineai/mcp@dev --version
+```
+
+See the `@caffeineai/mcp` README for host configuration.
+
+## Links
+
+- Caffeine platform: https://caffeine.ai
+
+This package installs the matching platform binary through npm optional dependencies. Install the main package rather than a platform package directly.

package/bin/caffeine.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawn, spawnSync } = require("node:child_process");
+
+const packages = {
+  "darwin-arm64": {
+    "packageName": "@caffeineai/cli-darwin-arm64",
+    "binary": "caffeine"
+  },
+  "darwin-x64": {
+    "packageName": "@caffeineai/cli-darwin-x64",
+    "binary": "caffeine"
+  },
+  "linux-arm64-glibc": {
+    "packageName": "@caffeineai/cli-linux-arm64-glibc",
+    "binary": "caffeine"
+  },
+  "linux-x64-glibc": {
+    "packageName": "@caffeineai/cli-linux-x64-glibc",
+    "binary": "caffeine"
+  },
+  "linux-arm64-musl": {
+    "packageName": "@caffeineai/cli-linux-arm64-musl",
+    "binary": "caffeine"
+  },
+  "linux-x64-musl": {
+    "packageName": "@caffeineai/cli-linux-x64-musl",
+    "binary": "caffeine"
+  },
+  "win32-arm64": {
+    "packageName": "@caffeineai/cli-win32-arm64",
+    "binary": "caffeine.exe"
+  },
+  "win32-x64": {
+    "packageName": "@caffeineai/cli-win32-x64",
+    "binary": "caffeine.exe"
+  }
+};
+
+function linuxLibc() {
+  if (process.platform !== "linux") return "";
+
+  try {
+    const report = process.report && process.report.getReport && process.report.getReport();
+    if (report && report.header && report.header.glibcVersionRuntime) return "glibc";
+  } catch {}
+
+  try {
+    const result = spawnSync("ldd", ["--version"], { encoding: "utf8" });
+    const text = String(result.stdout || "") + String(result.stderr || "");
+    if (text.toLowerCase().includes("musl")) return "musl";
+  } catch {}
+
+  return "glibc";
+}
+
+function platformKey() {
+  switch (process.platform) {
+    case "darwin":
+      return `darwin-${process.arch}`;
+    case "linux":
+      return `linux-${process.arch}-${linuxLibc()}`;
+    case "win32":
+      return `win32-${process.arch}`;
+    default:
+      return "";
+  }
+}
+
+const key = platformKey();
+const selected = packages[key];
+
+if (!selected) {
+  console.error("caffeine: unsupported platform " + process.platform + "/" + process.arch);
+  process.exit(1);
+}
+
+let bin;
+try {
+  bin = require.resolve(selected.packageName + "/bin/" + selected.binary);
+} catch {
+  console.error("caffeine: missing platform package " + selected.packageName);
+  console.error("Reinstall without --omit=optional.");
+  process.exit(1);
+}
+
+const child = spawn(bin, process.argv.slice(2), { stdio: "inherit" });
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    console.error("caffeine: terminated by " + signal);
+    process.exit(1);
+  }
+
+  process.exit(code ?? 0);
+});
+
+child.on("error", (err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@caffeineai/cli",
+  "version": "0.1.0-dev.0",
+  "description": "Caffeine CLI",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caffeinelabs/caffeine-cli.git"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "bin": {
+    "caffeine": "bin/caffeine.js",
+    "caf": "bin/caffeine.js",
+    "cfn": "bin/caffeine.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "@caffeineai/cli-darwin-arm64": "0.1.0-dev.0",
+    "@caffeineai/cli-darwin-x64": "0.1.0-dev.0",
+    "@caffeineai/cli-linux-arm64-glibc": "0.1.0-dev.0",
+    "@caffeineai/cli-linux-x64-glibc": "0.1.0-dev.0",
+    "@caffeineai/cli-linux-arm64-musl": "0.1.0-dev.0",
+    "@caffeineai/cli-linux-x64-musl": "0.1.0-dev.0",
+    "@caffeineai/cli-win32-arm64": "0.1.0-dev.0",
+    "@caffeineai/cli-win32-x64": "0.1.0-dev.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}