{"id":18140,"library":"autohand-cli","title":"Autohand Code CLI","description":"Autohand Code CLI v0.8.3 is an autonomous LLM-powered coding agent that uses the ReAct (Reason + Act) pattern to read, reason, and write code across entire projects from the terminal. Released as alpha (pre-release) with weekly commits, it features a modular skill system, multi-LLM provider support (OpenRouter, Anthropic, OpenAI, local models), Git integration, and an interactive REPL with slash commands and file autocomplete. Differentiated by autonomous multi-file editing with user approval gates and a minimalistic design, it requires Bun ≥1.0 and Node ≥18.17.0. The CLI ships TypeScript types and is under active development.","status":"active","version":"0.8.3","language":"javascript","source_language":"en","source_url":"https://github.com/autohandai/code-cli","tags":["javascript","cli","llm","agent","autohand","typescript"],"install":[{"cmd":"npm install autohand-cli","lang":"bash","label":"npm"},{"cmd":"yarn add autohand-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add autohand-cli","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Runtime requirement for installation and execution; build tool for manual install","package":"bun","optional":true},{"reason":"Required for version control features (auto-commit, file tracking)","package":"git","optional":false},{"reason":"Optional dependency for faster codebase search","package":"ripgrep","optional":true}],"imports":[{"note":"Package is ESM-only; CommonJS require is not supported.","wrong":"const autohand = require('autohand-cli')","symbol":"default","correct":"import autohand from 'autohand-cli'"},{"note":"TypeScript type export; available from v0.8.0+.","wrong":"","symbol":"AutohandConfig","correct":"import { AutohandConfig } from 'autohand-cli'"},{"note":"Programmatic API for running tasks; not documented in README but exported.","wrong":"","symbol":"runAutohand","correct":"import { runAutohand } from 'autohand-cli'"}],"quickstart":{"code":"import autohand from 'autohand-cli';\n\n// Interactive mode (launches REPL)\nautohand();\n\n// Command mode with auto-approval and commit\nautohand({\n  prompt: \"add a dark mode toggle to the settings page\",\n  yes: true,\n  autoCommit: true\n});\n\n// Dry-run with custom provider\nautohand({\n  prompt: \"refactor the auth module\",\n  dryRun: true,\n  provider: \"anthropic\",\n  apiKey: process.env.ANTHROPIC_API_KEY ?? ''\n});","lang":"typescript","description":"Demonstrates interactive and programmatic usage of Autohand CLI with provider configuration and dry-run mode."},"warnings":[{"fix":"Update Node to >=18.17.0 or use a compatible version like v0.8.2.","message":"v0.8.3-alpha requires Node >=18.17.0; older Node versions fail with ESM import errors.","severity":"breaking","affected_versions":"<0.8.3-alpha"},{"fix":"Use with caution in CI; monitor for API changes.","message":"The --repeat flag for non-interactive recurring mode is experimental and may change in future releases.","severity":"deprecated","affected_versions":"0.8.3-alpha"},{"fix":"Use Ctrl+C once to cancel a running task, Ctrl+C twice to exit.","message":"Pressing Ctrl+C twice exits immediately; single Ctrl+C only cancels in-flight requests.","severity":"gotcha","affected_versions":">=0.8.0"},{"fix":"Monitor subagent behavior and disable parallel execution if needed via config.","message":"Parallel tool execution in v0.8.3 may cause concurrency issues with subagents; depth-scaled concurrency is experimental.","severity":"gotcha","affected_versions":"0.8.3"},{"fix":"Break large pastes into smaller chunks or use file mentions (@file) instead.","message":"Smart paste feature sends full content to LLM; pasting large code blocks may exceed token limits.","severity":"gotcha","affected_versions":">=0.8.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'bun install -g autohand-cli' or use curl installer.","cause":"Package not installed or not globally linked.","error":"Error: Cannot find module 'autohand-cli'"},{"fix":"Use ESM import: `import autohand from 'autohand-cli'`.","cause":"Importing default export incorrectly with require() in ESM-only package.","error":"TypeError: autohand is not a function"},{"fix":"Upgrade Node.js to >=18.17.0 using nvm or Node.js installer.","cause":"Running on an older Node.js version.","error":"Error: Unsupported Node.js version. Node.js >=18.17.0 is required."},{"fix":"Install Git from https://git-scm.com and ensure it's in PATH.","cause":"Git is not installed or not accessible.","error":"Error: Git not found in PATH"},{"fix":"Set ANTHROPIC_API_KEY environment variable or pass via --api-key flag.","cause":"Invalid or missing API key for Anthropic provider.","error":"Error: Anthropic API error: 401 Unauthorized"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}