openhands

Delegate coding tasks to the OpenHands CLI in headless JSON mode.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill openhands-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openhands
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/optional-skills/autonomous-ai-agents/openhands
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill openhands-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Delegating multi-step coding work to an autonomous agent usually locks you into a single model vendor. This Skill wraps the OpenHands CLI so you can run batch, one-shot coding tasks through any LiteLLM-supported provider (OpenAI, Anthropic, OpenRouter, DeepSeek, Ollama, vLLM) directly from the terminal tool. ## Core Features & Use Cases - Headless Task Delegation: Run one-shot coding tasks with --headless --json --override-with-envs --exit-without-confirmation and parse the JSONL event stream. - Model-Agnostic Configuration: Select any LiteLLM model slug via LLM_MODEL, LLM_API_KEY, and LLM_BASE_URL environment variables. - Conversation Resumption: Continue prior runs with --resume <dashed-uuid> for iterative multi-turn coding sessions. - Use Case: Ask the agent to add error handling to all API calls in src/ of a project; OpenHands edits files and runs shell commands autonomously, returning a structured JSON event log. ## Quick Start Ask the agent to delegate a coding task to OpenHands, for example: use OpenHands headless mode with an OpenRouter model to add error handling to all API calls in the src directory of my project.

Frequently Asked Questions about openhands

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run OpenHands CLI in headless mode?▼

Run openhands with --headless --json --override-with-envs --exit-without-confirmation and pass the task via -t. Set LLM_MODEL, LLM_API_KEY, and LLM_BASE_URL environment variables, and export OPENHANDS_SUPPRESS_BANNER=1 to keep JSON output clean.

How do I install the OpenHands CLI?▼

Install it with uv tool install openhands --python 3.12, which requires Python 3.12 or newer. Do not use pip install openhands-ai, since that is the legacy V0 SDK package, not the current CLI.

Which models does OpenHands CLI support?▼

OpenHands is model-agnostic through LiteLLM, supporting OpenAI, Anthropic, OpenRouter, DeepSeek, Ollama, vLLM, and others. Set the full LiteLLM slug in LLM_MODEL, such as openrouter/anthropic/claude-sonnet-4.5 or anthropic/claude-sonnet-4-5.

Does OpenHands CLI work on Windows?▼

No, OpenHands has no native Windows support upstream and requires WSL on Windows machines. This Skill is gated to Linux and macOS platforms accordingly.

Why does OpenHands ignore my API key environment variables?▼

OpenHands ignores LLM_API_KEY, LLM_BASE_URL, and LLM_MODEL unless you pass --override-with-envs. Without that flag it falls back to ~/.openhands/settings.json and may hang on first-run setup.

How do I resume a previous OpenHands conversation?▼

Use openhands --resume <dashed-uuid> with the dashed conversation ID shown in the Hint line at the end of a run. The plain Conversation ID printed without dashes will not work for resuming.