@plori/cli 0.1.0

package/README.md

@@ -0,0 +1,61 @@
+# plori CLI
+
+`plori` drives your hosted agents (each one a cloud computer with its own
+disk, tools, and memory) from a terminal or a script. It is the CLI+skills
+counterpart to the remote MCP server at `https://api.plori.ai/mcp`: same
+account, same agents, same REST API underneath, and the commands mirror the
+MCP tool names (create_agent → `create`, invoke_agent → `run`,
+get_run_result → `result`, …).
+
+## Install
+
+Build from this repository (Go ≥ 1.25):
+
+```sh
+go build -o plori ./cli/cmd/plori
+```
+
+Binary releases and an npm wrapper (`@plori/cli`) are published per
+`docs/release-channels.md`.
+
+## Authenticate
+
+Create an API key at <https://plori.ai/settings>, then either:
+
+```sh
+plori login                  # prompts for the key, validates it, stores it 0600
+export PLORI_API_KEY=…       # or: environment (CI, agents)
+```
+
+`PLORI_BASE_URL` (or `--base-url`) points the CLI at a non-production
+control-plane, e.g. a local `uat-server`.
+
+## Use
+
+```sh
+plori create mate                        # get-or-create an agent named "mate"
+plori run mate "clone repo X and run the tests"
+plori run mate "long job" --no-wait      # returns a run id immediately
+plori result mate <run-id> --wait        # poll it later
+plori run mate "build it" --follow       # stream the turn live (tools on stderr)
+echo "summarize this" | plori run mate -  # message from stdin
+plori schedule mate "daily report" --in 86400
+plori inputs mate                        # runs paused on a human question
+plori answer <run-id> <tool-call-id> --approve
+plori credits && plori disk
+```
+
+Agents are addressed by name or UUID. Every command accepts `--json`; when
+stdout is not a TTY the output is JSON automatically, so scripts and agents
+can parse without flags. Errors go to stderr; exit codes: 0 success, 1 API
+failure, 2 usage error.
+
+## For agent authors
+
+The reply text of `plori run` is the only thing written to stdout (tool
+narration streams to stderr), so a calling agent can pipe it directly. A run
+that pauses on a human approval reports `status: "awaiting_input"`; surface
+it and answer with `plori answer`. Prefer one long-lived agent (`create`
+returns the existing agent for a reused name) over creating new ones.
+
+Wire-level acceptance cases live in [UAT.md](UAT.md).

package/bin/plori.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+// npm shim for the plori CLI. The real program is a Go binary shipped in a
+// platform-specific optionalDependency (the esbuild distribution pattern);
+// this script only locates it and execs it with stdio inherited.
+"use strict";
+const { spawnSync } = require("node:child_process");
+
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "@plori/cli-darwin-arm64",
+  "darwin-x64": "@plori/cli-darwin-x64",
+  "linux-x64": "@plori/cli-linux-x64",
+  "linux-arm64": "@plori/cli-linux-arm64",
+  "win32-x64": "@plori/cli-win32-x64",
+};
+
+function binPath() {
+  const key = `${process.platform}-${process.arch}`;
+  const pkg = PLATFORM_PACKAGES[key];
+  if (!pkg) {
+    console.error(`plori: unsupported platform ${key}; build from source with \`go build ./cli/cmd/plori\` (https://plori.ai)`);
+    process.exit(1);
+  }
+  const exe = process.platform === "win32" ? "plori.exe" : "plori";
+  try {
+    return require.resolve(`${pkg}/bin/${exe}`);
+  } catch {
+    console.error(
+      `plori: the platform binary package ${pkg} is missing.\n` +
+        "It installs as an optionalDependency; reinstall without --no-optional / --omit=optional.",
+    );
+    process.exit(1);
+  }
+}
+
+const result = spawnSync(binPath(), process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  console.error(`plori: ${result.error.message}`);
+  process.exit(1);
+}
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@plori/cli",
+  "description": "plori on the command line: give your AI agent its own cloud computer.",
+  "version": "0.1.0",
+  "license": "MIT",
+  "homepage": "https://plori.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/plori-ai/plori.git"
+  },
+  "keywords": [
+    "plori",
+    "ai-agents",
+    "cloud-computer",
+    "agent-hosting",
+    "cli",
+    "mcp"
+  ],
+  "bin": {
+    "plori": "bin/plori.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@plori/cli-darwin-arm64": "0.1.0",
+    "@plori/cli-darwin-x64": "0.1.0",
+    "@plori/cli-linux-x64": "0.1.0",
+    "@plori/cli-linux-arm64": "0.1.0",
+    "@plori/cli-win32-x64": "0.1.0"
+  }
+}