openhands
/openhands
Unified OpenHands plugin — bundles the OpenHands Cloud CLI, Cloud REST API (openhands-api), Automations (openhands-automation), and Software Agent SDK reference (openhands-sdk) into a single plugin. Use this when you need to interact with OpenHands Cloud or build agents with the SDK.
- Author
- OpenHands ↗
- Repository
- extensions ↗
- Licence
- MIT
- Last repository change
- 25.10.2026
Assessment and security
- Files in this package
- 11
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/run.sh
What it does and when to use it
Unified OpenHands plugin — bundles the OpenHands Cloud CLI, Cloud REST API (openhands-api), Automations (openhands-automation), and Software Agent SDK reference (openhands-sdk) into a single plugin. Use this when you need to interact with OpenHands Cloud or build agents with the SDK.
Original author description
Unified OpenHands plugin — bundles the OpenHands Cloud CLI, Cloud REST API (openhands-api), Automations (openhands-automation), and Software Agent SDK reference (openhands-sdk) into a single plugin. Use this when you need to interact with OpenHands Cloud or build agents with the SDK.
How it works
- Authentication — try CLI first
- Quick start — send a task via CLI
- Bundled skills
SKILL.md preview
---
name: openhands
description: >-
Unified OpenHands plugin — bundles the OpenHands Cloud CLI, Cloud REST API
(openhands-api), Automations (openhands-automation), and Software Agent SDK
reference (openhands-sdk) into a single plugin. Use this when you need to
interact with OpenHands Cloud or build agents with the SDK.
triggers:
- /openhands-cloud
---
# OpenHands — Cloud, API, Automations & SDK
This plugin bundles all OpenHands capabilities under one roof:
| Capability | Skill | When to use |
|---|---|---|
| **CLI** (`openhands cloud`) | — (plugin-only) | Send a task to Cloud and get a conversation URL |
| **Cloud REST API (V1)** | `openhands-api` | Start/inspect conversations, delegate work, access sandboxes |
| **Automations API** | `openhands-automation` | Create and manage scheduled cron tasks |
| **Software Agent SDK** | `openhands-sdk` | Build agents with the Python SDK — custom tools, LLMs, conversations, delegation |
Each capability is also available as a standalone skill under `skills/`.
This plugin provides a unified entry point and the CLI integration script.
## Authentication — try CLI first
1. **Check if the OpenHands CLI is installed:**
```bash
command -v openhands &>/dev/null && echo "CLI available" || echo "CLI not found"
```
PowerShell check:
```powershell
if (Get-Command openhands -ErrorAction SilentlyContinue) { "CLI available" } else { "CLI not found" }
```
2. **If CLI is available**, use it — it manages auth and API keys automatically.
3. **If CLI is not available**, check for an API key:
- Preferred env var: `OPENHANDS_CLOUD_API_KEY`
- Backward-compatible: `OPENHANDS_API_KEY`
- Header: `Authorization: Bearer <key>`
4. **If neither exists**, ask the user whether they'd like to install the CLI:
```bash
uv tool install openhands --python 3.12
openhands cloud # starts auth flow
```
## Quick start — send a task via CLI
```bash
./scripts/run.sh "Investigate flaky tests in tests/test_api.py"
```
The script checks for the CLI, installs it if needed, sends the task, and opens the resulting conversation URL.
On Windows, run this POSIX shell script from Git Bash or WSL (`bash scripts/run.sh "Investigate flaky tests in tests/test_api.py"`) unless a native PowerShell launcher is available.
If the script exits with code `2` (`AUTH_REQUIRED`), ask the user to complete authentication in the browser, then re-run.
## Bundled skills
For full API references, see the individual skills:
- **`skills/openhands-api`** — Cloud REST API: endpoints, polling, delegation, events, debugging, Python/TypeScript clients
- **`skills/openhands-automation`** — Automations API: presets, CRUD, cron schedules, plugin preset, custom automations
- **`skills/openhands-sdk`** — Software Agent SDK: building agents, custom tools, LLM config, conversations, sub-agent delegation, MCP, security, persistence
Files in this package (11)
- .claude-plugin 1 KB
- .codex-plugin 1 KB
- README.md 2 KB
- SKILL.md 3 KB
- .plugin/plugin.json 1 KB
- commands/create.md 2 KB
- commands/openhands-cloud.md 1 KB
- scripts/run.sh 2 KB
- skills/openhands-api 1 KB
- skills/openhands-automation 1 KB
- skills/openhands-sdk 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · OpenHands/extensions | 100 | MIT |
| TerminalSkills/skills | 100 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version 20e36845624d (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100openhands-sdk
Reference skill for the OpenHands Software Agent SDK - the Python framework for building AI agents that write software. Use when you need to build agents with the SDK, create custom tools, configure LLMs, manage conversations, delegate to sub-agents, or deploy agents locally or remotely. - 100openhands-sdk
Reference skill for the OpenHands Software Agent SDK - the Python framework for building AI agents that write software. Use when you need to build agents with the SDK, create custom tools, configure LLMs, manage conversations, delegate to sub-agents, or deploy agents locally or remotely. - 91openhands-automation
This skill should be used when the user asks to "create an automation", "schedule a task", "set up a cron job", "webhook integration", "event-triggered automation", or mentions automations, scheduled tasks, cron scheduling, or webhook events in OpenHands Cloud. - 91openhands-automation
This skill should be used when the user asks to "create an automation", "schedule a task", "set up a cron job", "webhook integration", "event-triggered automation", or mentions automations, scheduled tasks, cron scheduling, or webhook events in OpenHands Cloud. - 100cloud
Documentation reference for using Browser Use Cloud — the hosted API and SDK for browser automation. Use this skill whenever the user needs help with the Cloud REST API (v2, v3, or v4), browser-use-sdk (Python or TypeScript), X-Browser-Use-API-Key authentication, cloud sessions,… - 100agent-council
Run a structured multi-agent debate by spawning a panel of expert agents on any question, with convergence-aware iteration and typed synthesis output via the `agent-council` CLI. Use when a decision has genuine tradeoffs, high stakes, or hidden assumptions worth adversarial…