@snailer-team/snailer 1.0.7

package/README.md

@@ -0,0 +1,151 @@
+# @felixaihub/snailer
+
+> AI-Powered Development Agent for Your Terminal
+
+[![npm version](https://badge.fury.io/js/%40felixaihub%2Fsnailer.svg)](https://www.npmjs.com/package/@felixaihub/snailer)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## What is Snailer?
+
+Snailer is an intelligent AI coding agent that lives in your terminal. This npm package provides a convenient cross-platform installer for the Snailer CLI.
+
+```bash
+# Just describe what you want in plain English
+snailer --prompt "refactor the authentication module to use async/await"
+snailer --prompt "find all TODO comments and create GitHub issues"
+```
+
+## Quick Install
+
+### Global Installation
+
+```bash
+npm install -g @felixaihub/snailer
+```
+
+### Using npx (No Installation)
+
+```bash
+npx @felixaihub/snailer@latest --help
+```
+
+## Features
+
+- 🧠 **Self-Learning**: Improves with every interaction using ACE (Agentic Context Engineering)
+- 🔄 **Multi-Model Support**: Works with Claude, GPT, Grok, and Gemini
+- 🛠️ **Built-in Tools**: File operations, code search, git workflows, and more
+- ⚡ **Fast & Reliable**: Built with Rust for performance
+
+## Setup
+
+After installation, set up your AI API key:
+
+```bash
+# For Claude (recommended)
+export CLAUDE_API_KEY="your-api-key"
+
+# Or for OpenAI
+export OPENAI_API_KEY="your-api-key"
+
+# Or for xAI
+export XAI_API_KEY="your-api-key"
+```
+
+## Usage
+
+```bash
+# Start interactive mode (REPL)
+snailer
+
+# Execute a specific task (one-shot)
+snailer --prompt "Add error handling to the API module"
+
+# Get help
+snailer --help
+```
+
+## How It Works
+
+This npm package is an installer wrapper that:
+
+1. Downloads the appropriate Snailer binary from [GitHub Releases](https://github.com/felixaihub/snailer-cli/releases)
+2. Selects the correct binary for your platform (macOS, Linux, Windows)
+3. Installs it in a location accessible via the `snailer` command
+
+### Supported Platforms
+
+- **macOS**: x64, ARM64 (Apple Silicon)
+- **Linux**: x64, ARM64
+- **Windows**: x64
+
+### Binary Download
+
+During `npm install`, the package automatically:
+- Detects your platform and architecture
+- Downloads the corresponding binary from GitHub Releases
+- Makes it executable and available in your PATH
+
+### Offline Installation
+
+To skip the automatic download (useful for air-gapped environments):
+
+```bash
+SNAILER_SKIP_POSTINSTALL=1 npm install -g @felixaihub/snailer
+```
+
+Then manually download the binary from [Releases](https://github.com/felixaihub/snailer-cli/releases) and place it in the package's `bin/` directory.
+
+## Documentation
+
+For detailed documentation, visit the main repository:
+
+- [GitHub Repository](https://github.com/felixaihub/snailer-cli)
+- [Architecture Overview](https://github.com/felixaihub/snailer-cli/blob/main/ARCHITECTURE.md)
+- [Agent Documentation](https://github.com/felixaihub/snailer-cli/blob/main/docs/AGENT_ARCHITECTURE.md)
+- [ACE System](https://github.com/felixaihub/snailer-cli/blob/main/docs/ACE_SYSTEM.md)
+- [Contributing Guide](https://github.com/felixaihub/snailer-cli/blob/main/docs/CONTRIBUTING.md)
+
+## Troubleshooting
+
+### Binary download fails
+
+If the automatic download fails, you can:
+
+1. Manually download from [Releases](https://github.com/felixaihub/snailer-cli/releases)
+2. Place the binary in the package installation directory under `bin/`
+3. Make it executable: `chmod +x bin/snailer` (Unix-like systems)
+
+### Command not found
+
+If `snailer` command is not found after global installation:
+
+1. Check that npm's global bin directory is in your PATH:
+   ```bash
+   npm config get prefix
+   ```
+2. Add it to your PATH if needed (usually `~/.npm/bin` or `/usr/local/bin`)
+
+### Permission denied
+
+On Unix-like systems, if you get "permission denied":
+
+```bash
+chmod +x $(which snailer)
+```
+
+## License
+
+This installer package is licensed under the MIT License.
+
+The Snailer binary is subject to its own [End User License Agreement (EULA)](https://github.com/felixaihub/snailer-cli/blob/main/EULA.md).
+
+By installing and using Snailer, you agree to the terms in both licenses.
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/felixaihub/snailer-cli/issues)
+- **Website**: [snailer.ai](https://snailer.ai)
+
+---
+
+**Made with ❤️ by the Snailer Team**

package/bin/snailer.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+const { spawn } = require('node:child_process');
+const path = require('node:path');
+const os = require('node:os');
+const fs = require('node:fs');
+
+const binDir = path.join(__dirname, '..', 'bin');
+const exe = os.platform() === 'win32' ? 'snailer.exe' : 'snailer';
+const bin = path.join(binDir, exe);
+
+if (!fs.existsSync(bin)) {
+  console.error('[snailer] Binary is missing. Reinstall or download from Releases.');
+  process.exit(1);
+}
+
+const child = spawn(bin, process.argv.slice(2), { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code));

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@snailer-team/snailer",
+  "version": "1.0.7",
+  "description": "AI-powered development CLI (installer wrapper)",
+  "bin": {
+    "snailer": "bin/snailer.js"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "README.md",
+    "../EULA.md",
+    "../LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "repository": "https://github.com/felixaihub/snailer-cli",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,49 @@
+const { execSync } = require('node:child_process');
+const os = require('node:os');
+const fs = require('node:fs');
+const path = require('node:path');
+
+if (process.env.SNAILER_SKIP_POSTINSTALL === '1') {
+  console.log('[snailer] Skipping binary download (SNAILER_SKIP_POSTINSTALL=1).');
+  process.exit(0);
+}
+
+const org = process.env.SNAILER_ORG || 'felixaihub';
+const repo = process.env.SNAILER_REPO || 'snailer-cli';
+const version = 'v' + (process.env.npm_package_version || '0.1.0');
+
+function triple() {
+  const plat = os.platform();
+  const arch = os.arch();
+  if (plat === 'darwin' && arch === 'arm64') return 'aarch64-apple-darwin';
+  if (plat === 'darwin') return 'x86_64-apple-darwin';
+  if (plat === 'linux' && arch === 'arm64') return 'aarch64-unknown-linux-musl';
+  if (plat === 'linux') return 'x86_64-unknown-linux-musl';
+  if (plat === 'win32') return 'x86_64-pc-windows-msvc';
+  throw new Error(`Unsupported platform ${plat}/${arch}`);
+}
+
+const plat = os.platform();
+const isWin = plat === 'win32';
+const asset = `snailer-${version}-${triple()}.${isWin ? 'zip' : 'tar.gz'}`;
+const url = `https://github.com/${org}/${repo}/releases/download/${version}/${asset}`;
+
+const binDir = path.join(__dirname, '..', 'bin');
+fs.mkdirSync(binDir, { recursive: true });
+const tmp = path.join(os.tmpdir(), asset);
+
+try {
+  if (isWin) {
+    execSync(`powershell -NoProfile -Command \"Invoke-WebRequest -Uri '${url}' -OutFile '${tmp}'; Expand-Archive -LiteralPath '${tmp}' -DestinationPath '${binDir}' -Force\"`, { stdio: 'inherit' });
+  } else {
+    execSync(`curl -L '${url}' -o '${tmp}'`, { stdio: 'inherit' });
+    execSync(`tar -xzf '${tmp}' -C '${binDir}'`, { stdio: 'inherit' });
+    execSync(`chmod +x '${path.join(binDir, 'snailer')}'`, { stdio: 'inherit' });
+  }
+  console.log(`[snailer] Installed binary from ${url}`);
+  console.log('[snailer] By installing, you agree to the Snailer EULA: https://github.com/felixaihub/snailer-cli/blob/main/EULA.md');
+} catch (e) {
+  console.error('[snailer] Failed to download/install binary.');
+  console.error(`[snailer] Manual download: ${url}`);
+  process.exit(1);
+}