trooper-cli 0.1.3 → 0.1.5

package/README.md

@@ -0,0 +1,94 @@
+# trooper-cli
+
+Official command-line installer for Trooper's local desktop runtime.
+
+Trooper can run on your own Mac without a hosted cloud computer. This CLI installs the local bridge, starts the local AI gateway, and lets the Trooper desktop app pair the machine to your workspace.
+
+## Quick Start
+
+Install Trooper locally on this Mac:
+
+```bash
+npx -y trooper-cli
+```
+
+Then open the Trooper desktop app to connect this computer to your workspace.
+
+## What It Sets Up
+
+On macOS, `npx -y trooper-cli` prepares:
+
+- A local Trooper bridge on `http://127.0.0.1:3002`
+- A local AI gateway on `http://127.0.0.1:18789`
+- LaunchAgents so the local host can keep running
+- A Docker-compatible runtime using existing Docker or Colima when needed
+- Local runtime files under `~/Library/Application Support/Trooper/runtime`
+
+The local desktop plan does not require a Trooper cloud computer or Stripe checkout.
+
+## Commands
+
+### Install local runtime
+
+```bash
+npx -y trooper-cli
+```
+
+This is shorthand for:
+
+```bash
+npx -y trooper-cli onboard --yes
+```
+
+### Install with a Trooper setup token
+
+The Trooper app may generate a short-lived setup token for workspace pairing:
+
+```bash
+npx -y trooper-cli onboard --yes \
+  --token lst_example \
+  --api https://trooper-production.up.railway.app \
+  --platform macos
+```
+
+### Preview the installer command
+
+```bash
+npx -y trooper-cli --dry-run
+```
+
+### Uninstall local runtime
+
+```bash
+npx -y --prefer-online trooper-cli@latest uninstall --yes
+```
+
+This removes Trooper's local runtime, LaunchAgents, installer command file, and Trooper local Docker container. It leaves Docker, Colima, Homebrew, Node, and npm installed because those may be used by other projects.
+
+Keep local workspace/config data:
+
+```bash
+npx -y --prefer-online trooper-cli@latest uninstall --yes --keep-data
+```
+
+Also try to remove the desktop app:
+
+```bash
+npx -y --prefer-online trooper-cli@latest uninstall --yes --remove-app
+```
+
+## Requirements
+
+- Node.js 18 or newer
+- macOS for tokenless local desktop install
+- Administrator access may be requested if ownership repair or local runtime dependencies need it
+
+## Desktop App
+
+Local desktop install is meant to be started from the Trooper Mac or Windows app. The web onboarding page shows the plan, but only the desktop app can safely launch the local helper installer.
+
+## Links
+
+- Website: https://trooper.so
+- App: https://app.trooper.so
+- Package: https://www.npmjs.com/package/trooper-cli

package/bin/trooper.js

@@ -16,11 +16,13 @@ function printHelp() {
   console.log(`Trooper CLI
 
 Usage:
+  npx -y trooper-cli
   npx -y trooper-cli onboard --yes
   npx -y trooper-cli onboard --yes --token <setup-token>
   npx -y trooper-cli uninstall --yes
 
 Aliases:
+  no command            Same as onboard --yes
   setup                 Same as onboard
   remove                Same as uninstall
 
@@ -218,7 +220,7 @@ function runShellCommand(command, platform, { failureLabel = 'Command', successM
 
 async function main() {
   const args = parseArgs(process.argv.slice(2));
-  const command = args._[0] || 'help';
+  const command = args._[0] || 'onboard';
   if (args.help || args.h || command === 'help') {
     printHelp();
     return;

package/package.json

@@ -1,14 +1,34 @@
 {
   "name": "trooper-cli",
-  "version": "0.1.3",
-  "description": "Trooper local host setup CLI",
+  "version": "0.1.5",
+  "description": "Official Trooper CLI for installing and managing the local desktop AI runtime.",
   "type": "module",
   "bin": {
     "trooper": "bin/trooper.js"
   },
   "files": [
-    "bin"
+    "bin",
+    "README.md"
   ],
+  "keywords": [
+    "trooper",
+    "ai",
+    "local-ai",
+    "desktop-ai",
+    "agent",
+    "automation",
+    "macos",
+    "self-hosted"
+  ],
+  "homepage": "https://trooper.so",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/absurdfounder/Trooper.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/absurdfounder/Trooper/issues"
+  },
   "engines": {
     "node": ">=18"
   },