autoclaw 1.0.3 → 1.0.5

package/README.md

@@ -1,14 +1,23 @@
 # AutoClaw 🦞
 
-AutoClaw is a lightweight AI agent CLI tool that brings the power of Large Language Models (LLMs) directly to your terminal. It allows you to interact with your file system and execute commands using natural language.
+**The Docker-Native Headless Agent for Massive Scale Automation.**
+
+AutoClaw is a hyper-lightweight AI agent designed to live inside **Docker containers**. Unlike heavy, GUI-dependent agents, AutoClaw is built for **headless, massive-scale concurrency**.
+
+You can run one instance to fix a local script, or orchestrate **10,000+ instances** in a Kubernetes cluster to refactor codebases, audit servers, or process data streams in parallel.
+
+## Why AutoClaw?
+- 🐳 **Docker Native**: Built to run safely inside containers. Minimal footprint (Node.js/Alpine friendly).
+- 🚀 **Massive Scalability**: Text-only, headless design means you can spawn thousands of agents without consuming graphical resources.
+- 🛡️ **Sandbox Safety**: Ideal for running untrusted code when isolated in Docker.
+- 🔌 **Swarm Ready**: Stateless design allows for easy orchestration via K8s, Docker Swarm, or simple shell loops.
 
 ## Features
 
-- 💬 **Natural Language Interface**: Chat with your terminal to perform complex tasks.
-- 🛡️ **Safe Execution**: All shell commands require user confirmation before execution.
-- 📂 **File Management**: Read and write files effortlessly.
-- 🧠 **Context Aware**: Automatically detects your OS, shell, and environment for accurate command generation.
-- 🔌 **Model Agnostic**: Compatible with OpenAI, DeepSeek, LocalLLM, or any OpenAI-compatible API.
+- 📜 **Headless Execution**: No browsers, no GUIs. Pure terminal efficiency.
+- 🤖 **Non-Interactive**: Intelligent flag handling (`-y`) for zero-touch automation.
+- 📂 **Universal Control**: From simple file I/O to complex system administration.
+- 🧠 **Context Aware**: Detects container environments to optimize command strategies.
 
 ## Installation
 
@@ -43,18 +52,29 @@ npm update -g autoclaw
 
 ## Configuration
 
-AutoClaw uses a global JSON configuration file located at `~/.autoclaw/setting.json`.
-You can also use a local `.env` file in your current directory to override global settings.
+AutoClaw uses a hierarchical configuration system.
 
-Priority order:
-1. Command-line arguments (e.g., `-m`)
-2. Local `.env` file
-3. Global config (`~/.autoclaw/setting.json`)
+**Priority Order (Highest to Lowest):**
+1.  **CLI Arguments**: (e.g., `-m gpt-4o`)
+2.  **Environment Variables**: (`OPENAI_API_KEY`, `.env` file)
+3.  **Project Config**: (`./.autoclaw/setting.json` in current directory)
+4.  **Global Config**: (`~/.autoclaw/setting.json`)
 
-Supported Configuration Keys:
+### Supported Configuration Keys (JSON)
 - `apiKey`: Your API Key.
 - `baseUrl`: Custom Base URL.
-- `model`: Default model to use (default: `gpt-4o`).
+- `model`: Default model to use.
+
+### Project-Level Config (Example)
+Create a file at `.autoclaw/setting.json`:
+```json
+{
+  "model": "gpt-3.5-turbo",
+  "baseUrl": "https://api.example.com/v1"
+}
+```
+
+> **⚠️ Security Warning**: If you store your `apiKey` in `.autoclaw/setting.json`, make sure to add `.autoclaw/` to your `.gitignore` file to prevent leaking secrets!
 
 ## License
 

package/dist/agent.js

@@ -25,22 +25,22 @@ System Information:
         this.messages = [
             {
                 role: "system",
-                content: `You are AutoClaw, an advanced AI agent running in a CLI environment.
-Your goal is to help the user perform tasks on their computer.
-You have access to tools to execute shell commands and read/write files.
+                content: `You are AutoClaw, a Docker-Native Autonomous Agent designed for massive scale automation.
+You are likely running inside a container or headless server, possibly as one of thousands of parallel units in a swarm.
 
 CONTEXT:
 ${systemInfo}
 
+ENVIRONMENT CONSTRAINTS:
+1. HEADLESS: No GUI available. Do not try to open browsers or apps.
+2. CONTAINER-OPTIMIZED: Assume you are in a sandbox. You can be aggressive with file creation but robust with errors.
+3. NON-INTERACTIVE: Always use flags to suppress prompts (e.g., 'apt-get -y', 'rm -rf').
+
 GUIDELINES:
-1. Use the System Information above to generate platform-specific commands (e.g., use 'dir' for Windows, 'ls' for Linux).
-2. When asked to perform a task, analyze if you need to use tools.
-3. If you need to run a command, always use 'execute_shell_command' and provide a clear rationale.
-4. If you need to read a file, use 'read_file'.
-5. If you need to write a file, use 'write_file'.
-6. Be concise in your responses.
-7. If the user's request is ambiguous, ask for clarification.
-8. You are running on the user's local machine. Be careful with destructive commands (rm, etc.).
+1. EFFICIENCY: Your goal is speed and success. Write scripts that just work.
+2. ROBUSTNESS: Use standard Linux/Unix tools found in minimal images (Alpine/Debian).
+3. TOOLS: Use 'execute_shell_command' for actions, 'write_file' for code generation.
+4. CLARITY: Output concise logs. You are a worker unit, not a chat bot.
 `
             }
         ];

package/dist/index.js

@@ -8,15 +8,16 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
 import { fileURLToPath } from 'url';
-const CONFIG_DIR = path.join(os.homedir(), '.autoclaw');
-const CONFIG_FILE = path.join(CONFIG_DIR, 'setting.json');
-function loadGlobalConfig() {
-    if (fs.existsSync(CONFIG_FILE)) {
+const GLOBAL_CONFIG_DIR = path.join(os.homedir(), '.autoclaw');
+const GLOBAL_CONFIG_FILE = path.join(GLOBAL_CONFIG_DIR, 'setting.json');
+const LOCAL_CONFIG_FILE = path.join(process.cwd(), '.autoclaw', 'setting.json');
+function loadJsonConfig(filePath) {
+    if (fs.existsSync(filePath)) {
         try {
-            return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+            return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
         }
         catch (e) {
-            console.error(chalk.red("Error reading global config file."));
+            console.error(chalk.yellow(`Warning: Failed to parse config file at ${filePath}`));
         }
     }
     return {};
@@ -55,8 +56,8 @@ program
 program.parse(process.argv);
 async function runSetup() {
     console.log(chalk.bold.cyan("AutoClaw Setup Wizard 🦞\n"));
-    console.log(chalk.dim(`Config will be saved to: ${CONFIG_FILE}`));
-    const currentConfig = loadGlobalConfig();
+    console.log(chalk.dim(`Config will be saved to: ${GLOBAL_CONFIG_FILE}`));
+    const currentConfig = loadJsonConfig(GLOBAL_CONFIG_FILE);
     const answers = await inquirer.prompt([
         {
             type: 'password',
@@ -85,11 +86,11 @@ async function runSetup() {
         model: answers.model
     };
     try {
-        if (!fs.existsSync(CONFIG_DIR)) {
-            fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        if (!fs.existsSync(GLOBAL_CONFIG_DIR)) {
+            fs.mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
         }
-        fs.writeFileSync(CONFIG_FILE, JSON.stringify(newConfig, null, 2), { mode: 0o600 });
-        console.log(chalk.green(`\n✅ Configuration saved to ${CONFIG_FILE}`));
+        fs.writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(newConfig, null, 2), { mode: 0o600 });
+        console.log(chalk.green(`\n✅ Configuration saved to ${GLOBAL_CONFIG_FILE}`));
         console.log(chalk.cyan("You can now run 'autoclaw' to start using the agent."));
     }
     catch (error) {
@@ -98,12 +99,17 @@ async function runSetup() {
 }
 async function runChat(options) {
     console.log(chalk.bold.cyan("Welcome to AutoClaw CLI 🦞"));
-    // 1. Load Global (JSON)
-    const globalConfig = loadGlobalConfig();
-    // 2. Resolve final values (Priority: CLI > Env > Global JSON > Default)
-    let apiKey = process.env.OPENAI_API_KEY || globalConfig.apiKey;
-    let baseURL = process.env.OPENAI_BASE_URL || globalConfig.baseUrl;
-    let model = options.model || process.env.OPENAI_MODEL || globalConfig.model || 'gpt-4o';
+    // 1. Load Global JSON
+    const globalConfig = loadJsonConfig(GLOBAL_CONFIG_FILE);
+    // 2. Load Local JSON (Project Level)
+    const localConfig = loadJsonConfig(LOCAL_CONFIG_FILE);
+    if (Object.keys(localConfig).length > 0) {
+        console.log(chalk.dim(`Loaded project config from ${LOCAL_CONFIG_FILE}`));
+    }
+    // 3. Merge: CLI > Env > Local JSON > Global JSON
+    let apiKey = process.env.OPENAI_API_KEY || localConfig.apiKey || globalConfig.apiKey;
+    let baseURL = process.env.OPENAI_BASE_URL || localConfig.baseUrl || globalConfig.baseUrl;
+    let model = options.model || process.env.OPENAI_MODEL || localConfig.model || globalConfig.model || 'gpt-4o';
     if (!apiKey) {
         console.log(chalk.yellow("API Key not found."));
         const { doSetup } = await inquirer.prompt([
@@ -116,7 +122,7 @@ async function runChat(options) {
         ]);
         if (doSetup) {
             await runSetup();
-            const newConfig = loadGlobalConfig();
+            const newConfig = loadJsonConfig(GLOBAL_CONFIG_FILE);
             apiKey = newConfig.apiKey;
             baseURL = newConfig.baseUrl;
             model = options.model || newConfig.model || 'gpt-4o';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoclaw",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -33,7 +33,7 @@
   "dependencies": {
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
-    "dotenv": "^17.2.4",
+    "dotenv": "^16.4.7",
     "inquirer": "^13.2.2",
     "openai": "^6.18.0",
     "ora": "^9.3.0"