autohand-cli

library0.8.3jsnpmunverified

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.

llm-agents ai-ml devops

npm install autohand-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AUTOHAND-CLI

autohand-cli

llm-agentsjavascriptv0.8.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import autohand from 'autohand-cli'

✗ const autohand = require('autohand-cli')

Package is ESM-only; CommonJS require is not supported.

AutohandConfig

✓ import { AutohandConfig } from 'autohand-cli'

TypeScript type export; available from v0.8.0+.

runAutohand

✓ import { runAutohand } from 'autohand-cli'

Programmatic API for running tasks; not documented in README but exported.

Demonstrates interactive and programmatic usage of Autohand CLI with provider configuration and dry-run mode.

import autohand from 'autohand-cli'; // Interactive mode (launches REPL) autohand(); // Command mode with auto-approval and commit autohand({ prompt: "add a dark mode toggle to the settings page", yes: true, autoCommit: true }); // Dry-run with custom provider autohand({ prompt: "refactor the auth module", dryRun: true, provider: "anthropic", apiKey: process.env.ANTHROPIC_API_KEY ?? '' });

autohand --version

Debug

Known issues

breakingv0.8.3-alpha requires Node >=18.17.0; older Node versions fail with ESM import errors.

fix

Update Node to >=18.17.0 or use a compatible version like v0.8.2.

affects: <0.8.3-alpha

deprecatedThe --repeat flag for non-interactive recurring mode is experimental and may change in future releases.

fix

Use with caution in CI; monitor for API changes.

affects: 0.8.3-alpha

gotchaPressing Ctrl+C twice exits immediately; single Ctrl+C only cancels in-flight requests.

fix

Use Ctrl+C once to cancel a running task, Ctrl+C twice to exit.

affects: >=0.8.0

gotchaParallel tool execution in v0.8.3 may cause concurrency issues with subagents; depth-scaled concurrency is experimental.

fix

Monitor subagent behavior and disable parallel execution if needed via config.

affects: 0.8.3

gotchaSmart paste feature sends full content to LLM; pasting large code blocks may exceed token limits.

fix

Break large pastes into smaller chunks or use file mentions (@file) instead.

affects: >=0.8.0

Errors

Common errors & fixes

Error: Cannot find module 'autohand-cli'

Package not installed or not globally linked.

fix

Run 'bun install -g autohand-cli' or use curl installer.

TypeError: autohand is not a function

Importing default export incorrectly with require() in ESM-only package.

fix

Use ESM import: `import autohand from 'autohand-cli'`.

Error: Unsupported Node.js version. Node.js >=18.17.0 is required.

Running on an older Node.js version.

fix

Upgrade Node.js to >=18.17.0 using nvm or Node.js installer.

Error: Git not found in PATH

Git is not installed or not accessible.

fix

Install Git from https://git-scm.com and ensure it's in PATH.

Error: Anthropic API error: 401 Unauthorized

Invalid or missing API key for Anthropic provider.

fix

Set ANTHROPIC_API_KEY environment variable or pass via --api-key flag.

Upgrade

Version history

0.8.3latest on npm

Audit

Dependencies

bunoptionalRuntime requirement for installation and execution; build tool for manual install

gitrequiredRequired for version control features (auto-commit, file tracking)

ripgrepoptionalOptional dependency for faster codebase search

Agent activity

28 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/autohandai/code-cli ↗

packagehttps://www.npmjs.com/package/autohand-cli ↗

homepagehttps://autohand.ai/cli/ ↗