bone-agent 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vincent Miranda
+
+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,184 @@
+## bone-agent
+
+A CLI-based AI coding assistant capable of codebase search, file editing, computer use, and web search.
+
+<img width="1850" height="396" alt="image" src="https://github.com/user-attachments/assets/4f20cc22-a7d9-4423-afbf-15bbe1e29890" />
+
+## Features
+
+- **Multiple LLM Provider Support**: bone-agent (built-in proxy), OpenAI, Anthropic, OpenRouter, GLM, Gemini, Kimi, MiniMax, and local models
+- **Tool-Based Interaction**: Code search (`rg`), file editing, directory operations, and web search
+- **Multiple Modes**: Edit (full access), Plan (read-only), and Learn (documentation style)
+- **Parallel Execution**: Run multiple tools concurrently for efficiency
+- **Conversation History**: Markdown logging with context compaction
+- **Approval Workflows**: Safety checks for dangerous commands
+
+## Installation
+
+### Option 1: npm install (Recommended)
+
+```bash
+# Install globally (requires Python 3.9+)
+npm install -g bone-agent-cli
+
+# Run bone-agent
+bone-agent
+```
+
+Or use npx without installing:
+
+```bash
+npx bone-agent-cli
+```
+
+### What Gets Installed
+
+The npm package automatically:
+1. Checks for Python 3.9+ on your system
+2. Installs Python dependencies via pip
+3. Creates `~/.bone/config.yaml` from `config.yaml.example` if missing (persists across updates)
+4. Sets up the `bone-agent` command globally
+
+**Requirements:**
+- Node.js 14+ (for npm)
+- Python 3.9+ (for the application)
+- pip (to install Python dependencies)
+
+If Python is not found, the installer will guide you through installing it.
+
+### Option 2: Git Clone
+
+```bash
+# Clone the repository
+git clone https://github.com/vincentm65/bone-agent.git
+cd bone-agent
+
+# Install Python dependencies
+pip install -r requirements.txt
+
+# Run bone-agent
+python src/ui/main.py
+```
+
+**Requirements:**
+- Python 3.9+
+- pip (to install Python dependencies)
+
+## Configuration
+
+### Setting API Keys
+
+You have three options to set your API keys:
+
+#### Option 1: Interactive Commands (Recommended)
+
+Run the app and use the built-in commands:
+```
+> /key sk-your-api-key-here
+> /provider openai
+```
+
+#### Option 2: Edit config.yaml Directly
+
+Edit `~/.bone/config.yaml` and add your keys:
+
+```yaml
+# OpenAI
+OPENAI_API_KEY: "sk-your-key-here"
+OPENAI_MODEL: gpt-4o-mini
+
+# Anthropic (Claude)
+ANTHROPIC_API_KEY: "sk-ant-your-key-here"
+ANTHROPIC_MODEL: claude-3-5-sonnet-20241022
+
+# Or any other supported provider...
+```
+
+**Note:** Config is stored at `~/.bone/config.yaml` — it persists across npm updates and is never tracked by git.
+
+#### Option 3: Environment Variables
+
+Set environment variables (they take precedence over ~/.bone/config.yaml):
+
+```bash
+export OPENAI_API_KEY="sk-your-key-here"
+export ANTHROPIC_API_KEY="sk-ant-your-key-here"
+
+bone-agent
+```
+
+### Available Environment Variables
+
+- `ANTHROPIC_API_KEY` - Anthropic (Claude) API key
+- `OPENAI_API_KEY` - OpenAI API key
+- `GLM_API_KEY` - GLM (Zhipu AI) API key
+- `GEMINI_API_KEY` - Google Gemini API key
+- `OPENROUTER_API_KEY` - OpenRouter API key
+- `KIMI_API_KEY` - Kimi (Moonshot AI) API key
+- `MINIMAX_API_KEY` - MiniMax API key
+- `BONE_API_KEY` - bone-agent (proxy) API key (auto-set via `/signup`)
+- `BONE_API_BASE` - bone-agent (proxy) API base URL (default: `https://api.vmcode.dev`)
+
+## Commands
+
+- `/provider <name>` - Switch LLM provider
+- `/model <name>` - Set model for current provider
+- `/key <api_key>` - Set API key for current provider
+- `/mode <edit|plan|learn>` - Switch interaction mode
+- `/config` - Show all configuration settings
+- `/signup <email>` - Create a bone-agent account and get API key
+- `/account` - View your bone-agent account and plan details
+- `/plan` - View available plans and pricing
+- `/upgrade` - Upgrade your subscription
+- `/help` - Display all available commands
+
+/help Menu:
+<img width="1843" height="1349" alt="image" src="https://github.com/user-attachments/assets/631ab805-f012-4bb6-a031-c82a339e94c5" />
+
+
+## Project Structure
+
+```
+bone-agent/
+├── bin/
+│   ├── npm-wrapper.js  # npm entry point
+│   ├── rg              # ripgrep binary (Linux/macOS)
+│   └── rg.exe          # ripgrep binary (Windows)
+├── config.yaml.example # Configuration template
+├── requirements.txt    # Python dependencies
+├── package.json        # npm package definition
+├── .npmignore          # npm package exclusions
+├── .gitignore          # git exclusions
+├── src/
+│   ├── core/           # Core orchestration and state management
+│   ├── llm/            # LLM client and provider configurations
+│   ├── ui/             # CLI interface and commands
+│   └── utils/          # Utilities (file ops, search, validation)
+└── tests/              # Test suite (for development)
+```
+
+## bone-agent Plan (Built-in Proxy)
+
+bone-agent offers a built-in proxy provider for a seamless setup experience. Create an account and start coding without configuring third-party API keys.
+
+```
+> /signup you@example.com
+```
+
+Available plans: **Free**, **Lite**, and **Pro**. Use `/plan` to see details and `/upgrade` to change plans.
+
+*Paid plans coming soon.*
+
+## Security
+
+- User config lives at `~/.bone/config.yaml` — outside the repo and git, persists across updates
+- Never commit API keys or sensitive configuration
+- Use environment variables for CI/CD or shared environments
+
+## Development
+
+bone-agent is currently in active development. Production readiness is in progress with focus on:
+- Comprehensive test coverage
+- Documentation
+- Error handling improvements
+- Performance optimizations

package/bin/npm-wrapper.js

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+/**
+ * bone-agent - npm wrapper for Python application
+ * This script launches the Python bone-agent application
+ */
+
+const { spawn } = require('child_process');
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+// Get the package directory - handle both local and global npm installs
+// For global installs, the wrapper is typically in node_modules/.bin or npm's global bin directory
+let packageDir = __dirname;
+
+// First check if package.json exists in current directory (local install)
+if (!fs.existsSync(path.join(packageDir, 'package.json'))) {
+  // For global installs: check if we're in node_modules/.bin (go up to node_modules/package-name)
+  const nodeModulesBin = path.join(packageDir, '..', 'bone-agent-cli', 'package.json');
+  if (fs.existsSync(nodeModulesBin)) {
+    packageDir = path.join(packageDir, '..', 'bone-agent-cli');
+  } else {
+    // Alternative: walk up the directory tree looking for package.json
+    let found = false;
+    let searchDir = packageDir;
+    while (searchDir !== path.dirname(searchDir)) {
+      const pkgJson = path.join(searchDir, 'package.json');
+      if (fs.existsSync(pkgJson)) {
+        packageDir = searchDir;
+        found = true;
+        break;
+      }
+      searchDir = path.dirname(searchDir);
+    }
+    if (!found) {
+      console.error('Error: Could not find package.json. Installation may be corrupted.');
+      console.error(`Searched from: ${__dirname}`);
+      process.exit(1);
+    }
+  }
+}
+
+const pythonScript = path.join(packageDir, 'src', 'ui', 'main.py');
+
+function findPython() {
+  const possibleCommands = ['python3', 'python', 'python3.9', 'python3.10', 'python3.11', 'python3.12'];
+  
+  for (const cmd of possibleCommands) {
+    try {
+      const result = spawnSync(cmd, ['--version'], { stdio: 'ignore' });
+      if (result.status === 0) {
+        return cmd;
+      }
+    } catch (e) {
+      // Continue to next command
+    }
+  }
+  
+  return null;
+}
+
+function spawnSync(command, args, options) {
+  const { spawnSync: sync } = require('child_process');
+  return sync(command, args, options);
+}
+
+function checkPythonDependencies(pythonCmd) {
+  // Check if requirements are installed
+  const requirementsFile = path.join(packageDir, 'requirements.txt');
+  
+  if (!fs.existsSync(requirementsFile)) {
+    return true; // No requirements file, assume OK
+  }
+  
+  try {
+    // Try importing a key module to check if dependencies are installed
+    const result = spawnSync(pythonCmd, ['-c', 'import rich, requests, yaml, readability, html2text, ddgs, pathspec, prompt_toolkit, pygments'], {
+      stdio: 'ignore',
+      cwd: packageDir
+    });
+    
+    return result.status === 0;
+  } catch (e) {
+    return false;
+  }
+}
+
+function installPythonDependencies(pythonCmd) {
+  console.log('Installing Python dependencies...');
+  const requirementsFile = path.join(packageDir, 'requirements.txt');
+  
+  const installProcess = spawn(pythonCmd, ['-m', 'pip', 'install', '-r', requirementsFile], {
+    stdio: 'inherit',
+    cwd: packageDir
+  });
+  
+  return new Promise((resolve, reject) => {
+    installProcess.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Failed to install Python dependencies (exit code ${code})`));
+      }
+    });
+  });
+}
+
+function showSetupMessage() {
+  console.log('\n' + '='.repeat(60));
+  console.log('bone-agent - Terminal-based AI coding assistant');
+  console.log('='.repeat(60));
+  console.log('\nFirst-time setup needed!\n');
+  console.log('1. Python is required (3.9 or later)');
+  console.log('2. Python dependencies need to be installed\n');
+  console.log('To complete setup, run:');
+  console.log('  npm run install\n');
+  console.log('Or manually:');
+  console.log('  python3 -m pip install -r requirements.txt\n');
+  console.log('Then run bone-agent again.\n');
+}
+
+function ensureUserConfig() {
+  // User config lives in ~/.bone/config.yaml (persists across npm updates)
+  const boneDir = path.join(os.homedir(), '.bone');
+  const configFile = path.join(boneDir, 'config.yaml');
+  const configExample = path.join(packageDir, 'config.yaml.example');
+
+  if (!fs.existsSync(boneDir)) {
+    fs.mkdirSync(boneDir, { recursive: true });
+  }
+
+  if (!fs.existsSync(configFile)) {
+    if (fs.existsSync(configExample)) {
+      try {
+        fs.copyFileSync(configExample, configFile);
+        console.log('✓ Config created: ~/.bone/config.yaml');
+      } catch (e) {
+        console.log('Failed to create config:', e.message);
+      }
+    }
+  }
+
+  return configFile;
+}
+
+// Handle subcommands before launching Python
+const subcommand = process.argv[2];
+
+if (subcommand === 'update') {
+  console.log('Updating bone-agent-cli to latest version...');
+  const updateProcess = spawn('npm', ['install', '-g', 'bone-agent-cli@latest'], {
+    stdio: 'inherit',
+    shell: true
+  });
+
+  updateProcess.on('close', (code) => {
+    if (code === 0) {
+      console.log('\n✓ bone-agent-cli updated successfully');
+    } else {
+      console.error('\n❌ Update failed (exit code ' + code + ')');
+      console.error('Try running manually: npm install -g bone-agent-cli@latest');
+    }
+    process.exit(code || 0);
+  });
+
+  updateProcess.on('error', (err) => {
+    console.error('❌ Failed to run update:', err.message);
+    process.exit(1);
+  });
+  return;
+}
+
+async function main() {
+  // Find Python executable
+  const pythonCmd = findPython();
+  
+  if (!pythonCmd) {
+    console.error('\n❌ Error: Python 3.9+ is not installed or not in PATH');
+    console.error('Please install Python from https://python.org\n');
+    process.exit(1);
+  }
+  
+  console.log(`✓ Using Python: ${pythonCmd}`);
+  
+  // Check and install Python dependencies
+  if (!checkPythonDependencies(pythonCmd)) {
+    console.log('\n⚠️  Python dependencies not installed');
+    try {
+      await installPythonDependencies(pythonCmd);
+      console.log('✓ Python dependencies installed\n');
+    } catch (e) {
+      console.error('\n❌ Failed to install dependencies:', e.message);
+      console.error('Try running: npm run install\n');
+      process.exit(1);
+    }
+  }
+  
+  // Ensure user config exists in ~/.bone/ (persists across npm updates)
+  const userConfigPath = ensureUserConfig();
+  
+  // Run the Python application
+  // BONE_CONFIG_PATH points to user's persistent config.yaml in ~/.bone/
+  const pythonProcess = spawn(pythonCmd, [pythonScript], {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: {
+      ...process.env,
+      BONE_CONFIG_PATH: userConfigPath,
+    }
+  });
+  
+  pythonProcess.on('close', (code) => {
+    process.exit(code || 0);
+  });
+  
+  pythonProcess.on('error', (err) => {
+    console.error('\n❌ Failed to start bone-agent:', err.message);
+    process.exit(1);
+  });
+  
+  // Forward signals
+  process.on('SIGINT', () => {
+    pythonProcess.kill('SIGINT');
+  });
+  
+  process.on('SIGTERM', () => {
+    pythonProcess.kill('SIGTERM');
+  });
+}
+
+// Run main function
+main().catch(err => {
+  console.error('\n❌ Unexpected error:', err);
+  process.exit(1);
+});

package/config.yaml.example

@@ -0,0 +1,133 @@
+# bone-agent Configuration
+# Copy to config.yaml and add your API keys.
+# Keys can also be set via environment variables or: /key <api-key>  /provider <name>
+
+# -- General ------------------------------------------------------------------
+
+LAST_PROVIDER: bone
+
+# -- Provider API Keys --------------------------------------------------------
+
+# OpenAI
+OPENAI_API_KEY: "sk-your-openai-key-here"
+OPENAI_MODEL: gpt-4o-mini
+OPENAI_API_BASE: "https://api.openai.com/v1"
+
+# Anthropic
+ANTHROPIC_API_KEY: "sk-ant-your-anthropic-key-here"
+ANTHROPIC_MODEL: claude-3-5-sonnet-20241022
+ANTHROPIC_API_BASE: "https://api.anthropic.com/v1"
+
+# Google Gemini
+GEMINI_API_KEY: "your-gemini-key-here"
+GEMINI_MODEL: gemini-1.5-flash
+GEMINI_API_BASE: "https://generativelanguage.googleapis.com/v1beta"
+
+# Zhipu AI (GLM)
+GLM_API_KEY: "your-glm-key-here"
+GLM_MODEL: glm-4-flash
+GLM_API_BASE: "https://open.bigmodel.cn/api/paas/v4"
+
+# OpenRouter
+OPENROUTER_API_KEY: "sk-or-your-openrouter-key-here"
+OPENROUTER_MODEL: openai/gpt-4o-mini
+OPENROUTER_API_BASE: "https://openrouter.ai/api/v1"
+
+# Kimi (Moonshot AI)
+KIMI_API_KEY: "your-kimi-key-here"
+KIMI_MODEL: moonshot-v1-8k
+KIMI_API_BASE: "https://api.moonshot.cn/v1"
+
+# MiniMax (Anthropic-compatible API)
+MINIMAX_API_KEY: "your-minimax-key-here"
+MINIMAX_MODEL: "MiniMax-M2"
+MINIMAX_API_BASE: "https://api.minimax.io/anthropic/v1"
+
+# bone-agent Proxy (subscription — key from billing portal)
+BONE_PROXY_API_KEY: ""
+BONE_PROXY_MODEL: "openai/gpt-4o-mini"
+BONE_PROXY_API_BASE: "https://api.vmcode.dev"
+
+# -- Local Models (llama.cpp) -------------------------------------------------
+
+LOCAL_MODEL_PATH: "/path/to/your/model.gguf"
+LOCAL_SERVER_PATH: "/path/to/llama.cpp/build/bin/llama-server"
+
+SERVER_SETTINGS:
+  ngl_layers: 30
+  ctx_size: 8192
+  n_predict: 8192
+  rope_scale: 1.0
+  health_check_timeout_sec: 120
+  health_check_interval_sec: 1.0
+
+# -- Tool Settings ------------------------------------------------------------
+
+TOOL_SETTINGS:
+  max_tool_calls: 100
+  command_timeout_sec: 30
+  enable_parallel_execution: true
+  max_parallel_workers: 10
+  max_command_output_lines: 100
+  max_file_preview_lines: 200
+
+# -- File Settings ------------------------------------------------------------
+
+FILE_SETTINGS:
+  max_file_bytes: 200000
+  max_total_bytes: 1500000
+  exclude_dirs:
+    - .git
+    - .venv
+    - __pycache__
+    - node_modules
+    - venv
+    - env
+
+# -- Context Settings ---------------------------------------------------------
+# compact_trigger_tokens: reactive post-response compaction
+# hard_limit_tokens: proactive pre-send guard (defaults to 90% of max_context_window)
+
+CONTEXT_SETTINGS:
+  compact_trigger_tokens: 100000
+  max_context_window: 200000
+  hard_limit_tokens: 180000
+  notify_auto_compaction: true
+  log_conversations: false
+  conversations_dir: conversations
+  tool_compaction:
+    enable_per_message_compaction: true
+    uncompacted_tail_tokens: 40000
+    min_tool_blocks: 5
+    compact_failed_tools: true
+
+# -- Sub-Agent Settings -------------------------------------------------------
+
+SUB_AGENT_SETTINGS:
+  soft_limit_tokens: 300000
+  hard_limit_tokens: 500000
+  enable_compaction: false
+  dump_context_on_hard_limit: true
+
+# -- Status Bar ---------------------------------------------------------------
+
+STATUS_BAR_SETTINGS:
+  show_curr_tokens: true
+  show_in_tokens: true
+  show_out_tokens: true
+  show_total_tokens: true
+  show_cost: true
+
+# -- Integrations -------------------------------------------------------------
+
+# Obsidian vault (disabled by default — no token cost when off)
+OBSIDIAN_SETTINGS:
+  enabled: false
+  vault_path: ""
+  exclude_folders: ".obsidian,.trash,node_modules,.git,__pycache__"
+  project_base: "Dev"
+
+# Model pricing overrides (cost per 1M tokens)
+MODEL_PRICES: {}
+
+# Keep this file private. Env vars override values here. Run 'bone-agent /help' for reference.

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "bone-agent",
+  "version": "1.3.0",
+  "description": "A terminal-based AI coding assistant powered by OpenAI-style function calling",
+  "main": "src/ui/main.py",
+  "bin": {
+    "bone": "bin/npm-wrapper.js"
+  },
+  "files": [
+    "package.json",
+    "LICENSE",
+    "README.md",
+    "requirements.txt",
+    "config.yaml.example",
+    "bin/npm-wrapper.js",
+    "bin/rg",
+    "bin/rg.exe",
+    "src/**/*.py"
+  ],
+  "scripts": {
+    "postinstall": "echo 'bone-agent installed! Run with: bone'",
+    "start": "node bin/npm-wrapper.js"
+  },
+  "keywords": [
+    "ai",
+    "coding-assistant",
+    "terminal",
+    "llm",
+    "function-calling",
+    "python",
+    "gpt",
+    "claude",
+    "bone-agent"
+  ],
+  "author": "Vincent Miranda <vincentmiranda65@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vincentm65/vmCode-CLI.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vincentm65/vmCode-CLI/issues"
+  },
+  "homepage": "https://github.com/vincentm65/vmCode-CLI",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}

package/requirements.txt

@@ -0,0 +1,9 @@
+requests
+rich
+pathspec
+prompt-toolkit>=3.0.0
+ddgs
+readability-lxml
+html2text
+pyyaml
+pygments

package/src/__init__.py

@@ -0,0 +1,11 @@
+"""bone-agent - AI-powered coding assistant."""
+
+import json
+from pathlib import Path
+
+try:
+    _pkg_path = Path(__file__).resolve().parent.parent / "package.json"
+    with open(_pkg_path) as _f:
+        __version__ = json.load(_f)["version"]
+except Exception:
+    __version__ = "?.?.?"

package/src/core/__init__.py

@@ -0,0 +1 @@
+"""Core business logic for bone-agent."""