openhands

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

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill openhands-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openhands
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/autonomous-ai-agents/openhands
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill openhands-vivekgoquest

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 you can run headless, one-shot coding tasks on any LiteLLM-supported provider (OpenAI, Anthropic, OpenRouter, DeepSeek, Ollama, vLLM) directly from the terminal tool. ## Core Features & Use Cases - Headless batch delegation: Run one-shot coding tasks with --headless --json --override-with-envs --exit-without-confirmation and parse the JSONL event stream for actions, observations, and the final message. - Model-agnostic configuration: Select any LiteLLM model slug via LLM_MODEL, LLM_API_KEY, and LLM_BASE_URL environment variables, including doubly-prefixed OpenRouter slugs. - Conversation resume and background runs: Resume prior sessions with --resume <dashed-uuid> and run long tasks in the background with polling. - 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 JSONL transcript. ## 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 the JSON output clean.

How do I use OpenHands with OpenRouter or other model providers?▼

OpenHands uses LiteLLM model slugs via the LLM_MODEL environment variable. For OpenRouter use doubly-prefixed slugs like openrouter/openai/gpt-4o-mini with LLM_BASE_URL set to https://openrouter.ai/api/v1; for native providers use slugs like anthropic/claude-sonnet-4-5.

OpenHands vs Claude Code vs Codex: which coding agent should I use?▼

OpenHands is model-agnostic and works with any LiteLLM provider, while claude-code is Anthropic-only and codex is OpenAI-only. Choose OpenHands when you need providers like DeepSeek, Qwen, Ollama, or vLLM.

Does OpenHands CLI work on Windows?▼

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

Why does OpenHands ignore my LLM_API_KEY environment variable?▼

Without the --override-with-envs flag, OpenHands ignores LLM_API_KEY, LLM_BASE_URL, and LLM_MODEL and falls back to ~/.openhands/settings.json. On a fresh install that file does not exist, so the CLI hangs 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 a new -t task prompt to continue that session.