openhands

Delegate coding tasks to the OpenHands CLI in headless mode via LiteLLM providers.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill openhands-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openhands
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/autonomous-ai-agents/openhands
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill openhands-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Delegating multi-step coding work to an autonomous agent usually locks you into a single vendor's CLI. This Skill wraps the OpenHands CLI so coding tasks can run headlessly against any LiteLLM-supported model provider, including OpenRouter, DeepSeek, Ollama, and vLLM. ## Core Features & Use Cases - Headless Task Delegation: Run one-shot coding tasks with --headless --json and parse the JSONL event stream for actions, observations, and final results. - Model-Agnostic Configuration: Select any LiteLLM model slug through LLM_MODEL, LLM_API_KEY, and LLM_BASE_URL environment variables with --override-with-envs. - Conversation Resumption: Continue prior OpenHands sessions using the dashed conversation ID printed at the end of each run. - Use Case: Ask the agent to add error handling to every API call in a project's src/ directory using a DeepSeek model hosted on OpenRouter, running in the background while you continue other work. ## Quick Start Ask the agent to use OpenHands to add error handling to all API calls in your project's src directory with your configured LiteLLM model.

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 headless for automated coding tasks?▼

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.

OpenHands vs Claude Code vs Codex for delegating coding tasks?▼

OpenHands is model-agnostic and works with any LiteLLM provider such as DeepSeek, Qwen, Ollama, or OpenRouter. Claude Code is Anthropic-only and Codex is OpenAI-only, so prefer OpenHands when you need a non-Anthropic or non-OpenAI provider.

Does OpenHands CLI support Windows?▼

OpenHands has no native Windows support upstream; the documentation requires WSL on Windows. This Skill is gated to Linux and macOS platforms accordingly.

Why does OpenHands ignore my LLM_API_KEY environment variable?▼

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, which can cause a hang on fresh installs waiting for first-run setup.

How do I resume a previous OpenHands conversation?▼

Each run prints a Conversation ID and a Hint line with a dashed UUID. Pass the dashed form with --resume <dashed-uuid> along with your new task prompt to continue that conversation.

Why does OpenHands print LiteLLM warnings on every run?▼

The CLI emits bedrock-runtime and sagemaker-runtime warnings to stderr because botocore is not installed, plus an Authlib deprecation notice. These are noise, not failures; pipe stderr to /dev/null and parse only stdout lines starting with {.