edgecrab-cli 0.1.0

package/README.md

@@ -0,0 +1,104 @@
+# edgecrab-cli (npm)
+
+> **EdgeCrab** — Super Powerful Personal Assistant inspired by **NousHermes** and **OpenClaw**.  
+> Blazing-fast TUI · ReAct tool loop · Multi-provider LLM · ACP protocol · Single 15 MB static binary.
+
+[![npm](https://img.shields.io/npm/v/edgecrab-cli.svg)](https://www.npmjs.com/package/edgecrab-cli)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/raphaelmansuy/edgecrab/blob/main/LICENSE)
+
+---
+
+## Installation
+
+```bash
+# Global install (recommended) — adds `edgecrab` to your PATH
+npm install -g edgecrab-cli
+
+# Or use without a global install
+npx edgecrab-cli
+```
+
+The postinstall script automatically downloads the correct pre-built Rust binary for
+your platform (macOS arm64/x64, Linux x64/arm64, Windows x64) from
+[GitHub Releases](https://github.com/raphaelmansuy/edgecrab/releases).
+
+No Rust, GCC, or build tools are required.
+
+---
+
+## Quick Start
+
+```bash
+# First-run setup wizard — detects API keys, writes ~/.edgecrab/config.yaml
+edgecrab setup
+
+# Verify your environment
+edgecrab doctor
+
+# Start the interactive TUI
+edgecrab
+
+# One-shot query (pipe-friendly)
+edgecrab "summarise the git log for today"
+
+# Pick a specific LLM provider
+edgecrab --model anthropic/claude-opus-4 "explain this codebase"
+
+# Stream output
+edgecrab --quiet "write a Rust hello-world"
+```
+
+---
+
+## Why EdgeCrab?
+
+EdgeCrab is a **Rust-native** autonomous coding agent and personal assistant, inspired by
+the reasoning depth of **NousHermes** and the tool-use power of **OpenClaw**.
+
+| Feature | Detail |
+|---------|--------|
+| **Single binary** | 15 MB static binary, < 50 ms startup, ~15 MB resident memory |
+| **Multi-provider LLM** | Copilot · OpenAI · Anthropic · Gemini · xAI · DeepSeek · Ollama |
+| **ReAct tool loop** | File, terminal, web search, memory, process, skill tools |
+| **ratatui TUI** | 60 fps capable terminal UI with streaming output |
+| **ACP protocol** | Built-in JSON-RPC 2.0 stdio adapter for VS Code Copilot |
+| **Built-in security** | Path safety, SSRF protection, command scanning, output redaction |
+
+---
+
+## Alternative Installation Methods
+
+| Method | Command |
+|--------|---------|
+| **npm** | `npm install -g edgecrab-cli` |
+| **PyPI** | `pip install edgecrab-cli` |
+| **Cargo** | `cargo install edgecrab-cli` |
+| **Docker** | `docker pull ghcr.io/raphaelmansuy/edgecrab:latest` |
+| **Pre-built binary** | [GitHub Releases](https://github.com/raphaelmansuy/edgecrab/releases) |
+
+---
+
+## Supported Platforms
+
+| Platform | Architecture |
+|----------|-------------|
+| macOS | Apple Silicon (arm64) · Intel (x64) |
+| Linux | x86_64 · arm64 |
+| Windows | x64 |
+
+---
+
+## Documentation
+
+Full docs: **[edgecrab.com](https://www.edgecrab.com)**
+
+- [Quick Start](https://www.edgecrab.com/getting-started/quick-start/)
+- [Installation Guide](https://www.edgecrab.com/getting-started/installation/)
+- [CLI Commands Reference](https://www.edgecrab.com/reference/cli-commands/)
+- [Provider Setup](https://www.edgecrab.com/providers/)
+
+---
+
+## License
+
+MIT © [Raphael Mansuy](https://github.com/raphaelmansuy)

package/bin/edgecrab.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * Thin launcher for the EdgeCrab native binary.
+ *
+ * This script is the `bin` entry point for `edgecrab-cli` on npm.
+ * It resolves the platform-specific binary installed by `postinstall`,
+ * then spawns it with all arguments forwarded.
+ */
+
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const BINARY  = process.platform === 'win32' ? 'edgecrab.exe' : 'edgecrab';
+const BIN_DIR = path.join(__dirname, BINARY);
+
+if (!fs.existsSync(BIN_DIR)) {
+  console.error(
+    `[edgecrab-cli] Native binary not found at: ${BIN_DIR}\n` +
+    `[edgecrab-cli] Re-run: npm install edgecrab-cli\n` +
+    `[edgecrab-cli] Or install from source: cargo install edgecrab-cli`
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(BIN_DIR, process.argv.slice(2), {
+  stdio: 'inherit',
+  env: process.env,
+});
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "edgecrab-cli",
+  "version": "0.1.0",
+  "description": "EdgeCrab — Super Powerful Personal Assistant inspired by NousHermes and OpenClaw. Single 15 MB static binary. Blazing-fast TUI, ReAct tool loop, multi-provider LLM.",
+  "license": "MIT",
+  "homepage": "https://www.edgecrab.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/raphaelmansuy/edgecrab.git",
+    "directory": "sdks/npm-cli"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "llm",
+    "edgecrab",
+    "coding-agent",
+    "personal-assistant",
+    "cli",
+    "rust",
+    "nous-hermes",
+    "openclaw"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "edgecrab": "./bin/edgecrab.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md"
+  ],
+  "dependencies": {}
+}

package/scripts/install.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+/**
+ * Postinstall: download the correct EdgeCrab native binary for the current
+ * platform and architecture from GitHub Releases.
+ *
+ * Supported platforms:
+ *   darwin-arm64   → edgecrab-aarch64-apple-darwin.tar.gz
+ *   darwin-x64     → edgecrab-x86_64-apple-darwin.tar.gz
+ *   linux-x64      → edgecrab-x86_64-unknown-linux-gnu.tar.gz
+ *   linux-arm64    → edgecrab-aarch64-unknown-linux-gnu.tar.gz
+ *   win32-x64      → edgecrab-x86_64-pc-windows-msvc.zip
+ */
+
+'use strict';
+
+const https = require('node:https');
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+const { execSync } = require('node:child_process');
+const { createGunzip } = require('node:zlib');
+
+// ─── Config ──────────────────────────────────────────────────────────────────
+const VERSION = require('../package.json').version;
+const REPO    = 'raphaelmansuy/edgecrab';
+const BINARY  = process.platform === 'win32' ? 'edgecrab.exe' : 'edgecrab';
+const BIN_DIR = path.join(__dirname, '..', 'bin');
+const DEST    = path.join(BIN_DIR, BINARY);
+
+// ─── Platform map ─────────────────────────────────────────────────────────────
+const PLATFORM_MAP = {
+  'darwin-arm64':  `edgecrab-aarch64-apple-darwin.tar.gz`,
+  'darwin-x64':    `edgecrab-x86_64-apple-darwin.tar.gz`,
+  'linux-x64':     `edgecrab-x86_64-unknown-linux-gnu.tar.gz`,
+  'linux-arm64':   `edgecrab-aarch64-unknown-linux-gnu.tar.gz`,
+  'win32-x64':     `edgecrab-x86_64-pc-windows-msvc.zip`,
+};
+
+const key = `${process.platform}-${os.arch()}`;
+const archive = PLATFORM_MAP[key];
+
+if (!archive) {
+  console.error(`[edgecrab-cli] Unsupported platform: ${key}`);
+  console.error(`[edgecrab-cli] Please build from source: https://github.com/${REPO}`);
+  process.exit(0); // non-fatal — SDK still works
+}
+
+const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${archive}`;
+
+// Skip download in CI if binary already exists (cache hit)
+if (fs.existsSync(DEST)) {
+  console.log(`[edgecrab-cli] Binary already present: ${DEST}`);
+  process.exit(0);
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+/**
+ * Follow redirects and return the final response.
+ * @param {string} downloadUrl
+ * @returns {Promise<import('node:http').IncomingMessage>}
+ */
+function fetchFollowRedirects(downloadUrl) {
+  return new Promise((resolve, reject) => {
+    const req = https.get(downloadUrl, { headers: { 'User-Agent': 'edgecrab-npm-installer' } }, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        resolve(fetchFollowRedirects(res.headers.location));
+      } else if (res.statusCode === 200) {
+        resolve(res);
+      } else {
+        reject(new Error(`HTTP ${res.statusCode} for ${downloadUrl}`));
+      }
+    });
+    req.on('error', reject);
+  });
+}
+
+/**
+ * Extract the binary from a .tar.gz archive into BIN_DIR.
+ * @param {string} tarPath  path to the downloaded .tar.gz
+ */
+function extractTarGz(tarPath) {
+  // Use system tar if available (macOS and Linux always have it)
+  execSync(`tar -xzf "${tarPath}" -C "${BIN_DIR}" --strip-components=0 "${BINARY}" 2>/dev/null || tar -xzf "${tarPath}" -C "${BIN_DIR}"`, { stdio: 'pipe' });
+}
+
+/**
+ * Extract the binary from a .zip archive into BIN_DIR.
+ * @param {string} zipPath
+ */
+function extractZip(zipPath) {
+  // PowerShell is available on all modern Windows
+  execSync(`powershell -Command "Expand-Archive -Path '${zipPath}' -DestinationPath '${BIN_DIR}' -Force"`, { stdio: 'pipe' });
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+
+  const tmpFile = path.join(os.tmpdir(), `edgecrab-install-${Date.now()}.${archive.endsWith('.zip') ? 'zip' : 'tar.gz'}`);
+
+  console.log(`[edgecrab-cli] Downloading ${archive} ...`);
+
+  try {
+    const res = await fetchFollowRedirects(url);
+    await new Promise((resolve, reject) => {
+      const out = fs.createWriteStream(tmpFile);
+      res.pipe(out);
+      out.on('finish', resolve);
+      out.on('error', reject);
+    });
+  } catch (err) {
+    console.error(`[edgecrab-cli] Download failed: ${err.message}`);
+    console.error(`[edgecrab-cli] You can install manually: cargo install edgecrab-cli`);
+    process.exit(0); // non-fatal
+  }
+
+  try {
+    if (archive.endsWith('.zip')) {
+      extractZip(tmpFile);
+    } else {
+      extractTarGz(tmpFile);
+    }
+    fs.chmodSync(DEST, 0o755);
+    console.log(`[edgecrab-cli] Installed: ${DEST}`);
+  } catch (err) {
+    console.error(`[edgecrab-cli] Extraction failed: ${err.message}`);
+    console.error(`[edgecrab-cli] You can install manually: cargo install edgecrab-cli`);
+  } finally {
+    try { fs.unlinkSync(tmpFile); } catch (_) { /* ignore */ }
+  }
+}
+
+main().catch((err) => {
+  console.error(`[edgecrab-cli] Unexpected error: ${err.message}`);
+  process.exit(0); // always non-fatal to avoid blocking npm install
+});