@alius-tech/alius 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 WeiXuG
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,161 @@
+# @alius-tech/alius
+
+**Hermes Agent 工程实践** - 探索 LLM Agent 的工业化落地与软件自进化范式。
+
+[![npm version](https://img.shields.io/npm/v/@alius-tech/alius.svg)](https://www.npmjs.com/package/@alius-tech/alius)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![GitHub](https://img.shields.io/badge/GitHub-AliusTech/alius-black.svg)](https://github.com/AliusTech/alius)
+
+## 关于 Alius
+
+Alius 是一个交互式的 LLM 命令行工具，作为 **Hermes Agent 工程实践**和**软件自进化**的探索平台：
+
+- **工具调用架构** - 模块化、可扩展的工具系统设计
+- **交互范式** - REPL 模式下的自然语言交互
+- **工程化落地** - 从原型到生产级的演进路径
+- **软件自进化** - AI 辅助下的代码改进、测试生成、文档维护
+
+## Installation
+
+```bash
+# Install globally via npm
+npm install -g @alius-tech/alius
+
+# Or using yarn
+yarn global add @alius-tech/alius
+
+# Or using pnpm
+pnpm add -g @alius-tech/alius
+```
+
+## Quick Start
+
+```bash
+# Start interactive REPL mode
+alius
+
+# Run a single prompt
+alius run "What files are in this directory?"
+
+# Show help
+alius --help
+
+# Show version
+alius version
+```
+
+## Features
+
+- 🤖 **AI-Powered Assistant** - Powered by LLM models (OpenAI GPT, Anthropic Claude)
+- 🔧 **Built-in Tools** - File operations, shell commands, git, HTTP requests, and more
+- 💬 **Interactive REPL** - Conversation-style interface with session management
+- 🔐 **Permission System** - Granular control over tool execution permissions
+- 📝 **Session Persistence** - Save and resume conversations
+- 🎯 **Smart Tool Calling** - Automatic tool selection based on context
+
+## Built-in Tools
+
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read file contents |
+| `write_file` | Write/create files |
+| `edit_file` | Edit existing files |
+| `list_dir` | List directory contents |
+| `shell` | Execute shell commands |
+| `git_status` | Check git repository status |
+| `git_diff` | View git differences |
+| `http_request` | Make HTTP requests |
+| `json` | Parse and query JSON data |
+| `code_stats` | Analyze code statistics |
+
+## Configuration
+
+Create a config file at `~/.alius/config.toml`:
+
+```toml
+[llm]
+provider = "openai"  # or "anthropic"
+model = "gpt-4o-mini"  # or "claude-3-haiku-20240307"
+
+[ui]
+theme = "dark"
+```
+
+## Supported Platforms
+
+| Platform | Architecture | Package |
+|----------|-------------|---------|
+| macOS | Intel x64 | `@alius-tech/alius-darwin-x64` |
+| macOS | Apple Silicon arm64 | `@alius-tech/alius-darwin-arm64` |
+| Linux | x64 | `@alius-tech/alius-linux-x64` |
+| Linux | arm64 | `@alius-tech/alius-linux-arm64` |
+| Windows | x64 | `@alius-tech/alius-win32-x64` |
+| Windows | arm64 | `@alius-tech/alius-win32-arm64` |
+
+The correct platform package is automatically installed as an optional dependency.
+
+## Alternative Installation Methods
+
+### Homebrew (macOS)
+
+```bash
+brew tap AliusTech/alius
+brew install alius
+```
+
+### Direct Download
+
+Download pre-built binaries from [GitHub Releases](https://github.com/AliusTech/alius/releases):
+
+```bash
+# macOS/Linux
+curl -sSL https://github.com/AliusTech/alius/releases/latest/download/alius-$(uname -s)-$(uname -m).tar.gz | tar xz
+
+# Windows (PowerShell)
+Invoke-WebRequest -Uri "https://github.com/AliusTech/alius/releases/latest/download/alius-windows-x64.zip" -OutFile "alius.zip"
+Expand-Archive alius.zip
+```
+
+### From Source
+
+```bash
+git clone https://github.com/AliusTech/alius.git
+cd alius
+cargo build --release
+cargo install --path crates/alius-cli
+```
+
+## API Keys
+
+Alius requires API keys to communicate with LLM providers:
+
+- **OpenAI**: Set `OPENAI_API_KEY` environment variable or configure in config file
+- **Anthropic**: Set `ANTHROPIC_API_KEY` environment variable or configure in config file
+
+```bash
+export OPENAI_API_KEY="your-api-key"
+alius
+```
+
+## Requirements
+
+- Node.js >= 16 (for npm installation)
+- Rust >= 1.70 (for building from source)
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](https://github.com/AliusTech/alius/blob/main/CONTRIBUTING.md).
+
+## License
+
+MIT License - see [LICENSE](https://github.com/AliusTech/alius/blob/main/LICENSE).
+
+## Links
+
+- [GitHub Repository](https://github.com/AliusTech/alius)
+- [Issue Tracker](https://github.com/AliusTech/alius/issues)
+- [Changelog](https://github.com/AliusTech/alius/blob/main/CHANGELOG.md)
+
+---
+
+Made with ❤️ by **Alius Tech**

package/bin/alius.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+/**
+ * Platform detection and binary execution wrapper for Alius CLI
+ * Automatically selects and runs the correct native binary for the current platform
+ *
+ * @author Alius Tech
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+// Platform detection
+const PLATFORM = os.platform();
+const ARCH = os.arch();
+
+// Platform to npm package mapping
+const PLATFORM_PACKAGES = {
+  'darwin-x64': '@alius-tech/alius-darwin-x64',
+  'darwin-arm64': '@alius-tech/alius-darwin-arm64',
+  'linux-x64': '@alius-tech/alius-linux-x64',
+  'linux-arm64': '@alius-tech/alius-linux-arm64',
+  'win32-x64': '@alius-tech/alius-win32-x64',
+  'win32-arm64': '@alius-tech/alius-win32-arm64',
+};
+
+// Binary names per platform
+const BINARY_NAMES = {
+  darwin: 'alius',
+  linux: 'alius',
+  win32: 'alius.exe',
+};
+
+/**
+ * Get the platform key for current system
+ */
+function getPlatformKey() {
+  return `${PLATFORM}-${ARCH}`;
+}
+
+/**
+ * Get the binary name for current platform
+ */
+function getBinaryName() {
+  return BINARY_NAMES[PLATFORM] || 'alius';
+}
+
+/**
+ * Find the native binary path
+ * Tries multiple locations to handle different installation scenarios
+ */
+function findBinary() {
+  const platformKey = getPlatformKey();
+  const packageName = PLATFORM_PACKAGES[platformKey];
+  const binaryName = getBinaryName();
+
+  if (!packageName) {
+    console.error(`\n✗ Unsupported platform: ${platformKey}`);
+    console.error('\nSupported platforms:');
+    console.error('  - darwin-x64   (macOS Intel)');
+    console.error('  - darwin-arm64 (macOS Apple Silicon)');
+    console.error('  - linux-x64    (Linux x86_64)');
+    console.error('  - linux-arm64  (Linux ARM64)');
+    console.error('  - win32-x64     (Windows x86_64)');
+    console.error('  - win32-arm64   (Windows ARM64)');
+    process.exit(1);
+  }
+
+  // Possible binary locations
+  const possiblePaths = [
+    // Try platform package's index.js export
+    (() => {
+      try {
+        const platformPkg = require(packageName);
+        return platformPkg.binaryPath || platformPkg.getBinaryPath?.();
+      } catch { return null; }
+    })(),
+
+    // Sibling package directory (npm scoped package and local monorepo layouts)
+    path.join(__dirname, '..', '..', packageName.split('/').pop(), 'bin', binaryName),
+
+    // Vendor directory (for bundled distribution)
+    path.join(__dirname, '..', 'vendor', platformKey, 'bin', binaryName),
+
+    // Adjacent to this script (development)
+    path.join(__dirname, binaryName),
+  ].filter(Boolean);
+
+  // Find existing binary
+  for (const binaryPath of possiblePaths) {
+    if (binaryPath && fs.existsSync(binaryPath)) {
+      return binaryPath;
+    }
+  }
+
+  // Binary not found - show helpful error message
+  console.error(`\n✗ Alius binary not found for platform: ${platformKey}`);
+  console.error(`\nThis could mean:`);
+  console.error('  1. The platform package was not installed correctly');
+  console.error('  2. The binary download failed');
+  console.error('  3. An incompatible version was installed');
+  console.error('\nTroubleshooting:');
+  console.error('  1. Clear npm cache: npm cache clean --force');
+  console.error('  2. Reinstall: npm uninstall -g @alius-tech/alius && npm install -g @alius-tech/alius');
+  console.error('  3. Check platform: node -e "console.log(process.platform + "-" + process.arch)"');
+  console.error('\nOr download manually from:');
+  console.error('  https://github.com/AliusTech/alius/releases');
+  process.exit(1);
+}
+
+/**
+ * Run the native binary with forwarded arguments and signals
+ */
+function run() {
+  const binaryPath = findBinary();
+  const args = process.argv.slice(2);
+
+  // Spawn the native binary
+  const child = spawn(binaryPath, args, {
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      // Pass platform info to the binary
+      ALIUS_PLATFORM: getPlatformKey(),
+      ALIUS_WRAPPER: 'true',
+    },
+  });
+
+  // Forward termination signals to child process
+  const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+  signals.forEach((signal) => {
+    process.on(signal, () => {
+      // Only forward if child is alive
+      if (!child.killed) {
+        child.kill(signal);
+      }
+    });
+  });
+
+  // Handle child process exit
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      // Re-emit signal so parent exits the same way
+      process.kill(process.pid, signal);
+    } else {
+      process.exit(code ?? 0);
+    }
+  });
+
+  // Handle child process error
+  child.on('error', (err) => {
+    console.error(`\n✗ Failed to run Alius: ${err.message}`);
+    console.error(`\nBinary path: ${binaryPath}`);
+    process.exit(1);
+  });
+}
+
+// Run CLI
+run();

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@alius-tech/alius",
+  "version": "0.0.1",
+  "description": "Alius CLI - An AI-powered assistant with intelligent tool calling capabilities",
+  "keywords": [
+    "ai",
+    "cli",
+    "assistant",
+    "llm",
+    "agent",
+    "openai",
+    "anthropic",
+    "claude",
+    "tools",
+    "repl"
+  ],
+  "author": {
+    "name": "Alius Tech",
+    "email": "alius@aliustech.com",
+    "url": "https://aliustech.com"
+  },
+  "contributors": [
+    {
+      "name": "WeiXuG",
+      "url": "https://github.com/weixug"
+    }
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AliusTech/alius.git",
+    "directory": "npm-packages/alius"
+  },
+  "bugs": {
+    "url": "https://github.com/AliusTech/alius/issues"
+  },
+  "homepage": "https://github.com/AliusTech/alius#readme",
+  "bin": {
+    "alius": "./bin/alius.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "@alius-tech/alius-darwin-x64": "0.0.1",
+    "@alius-tech/alius-darwin-arm64": "0.0.1",
+    "@alius-tech/alius-linux-x64": "0.0.1",
+    "@alius-tech/alius-win32-x64": "0.0.1"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/AliusTech/alius?sponsor=1"
+  }
+}