@openhands/extensions 0.20.0 → 0.22.0

package/skills/iterate/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "iterate",
+  "version": "1.0.0",
+  "description": "Iterate on a GitHub pull request — drive it through CI, code review, and QA until it is merge-ready.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": ["github", "ci", "review", "qa", "pull-request", "iterate"]
+}

package/skills/iterate/.codex-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "iterate",
+  "version": "1.0.0",
+  "description": "Iterate on a GitHub pull request — drive it through CI, code review, and QA until it is merge-ready.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": ["github", "ci", "review", "qa", "pull-request", "iterate"]
+}

package/skills/jira-issue-to-pr/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "jira-issue-to-pr",
+  "version": "1.0.0",
+  "description": "Deploy a cron-based OpenHands automation that watches a Jira Cloud project for issues labeled with a configurable label (default: create-pr) and spawns an agent conversation to create a GitHub pull request for each new issue found. The target GitHub repo is read from the ticket body - no repo parameter required at deploy time.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "jira",
+    "atlassian",
+    "github",
+    "pull-request",
+    "automation"
+  ]
+}

package/skills/jira-issue-to-pr/.codex-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "jira-issue-to-pr",
+  "version": "1.0.0",
+  "description": "Deploy a cron-based OpenHands automation that watches a Jira Cloud project for issues labeled with a configurable label (default: create-pr) and spawns an agent conversation to create a GitHub pull request for each new issue found. The target GitHub repo is read from the ticket body - no repo parameter required at deploy time.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "jira",
+    "atlassian",
+    "github",
+    "pull-request",
+    "automation"
+  ]
+}

package/skills/jupyter/.claude-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+  "name": "jupyter",
+  "version": "1.0.0",
+  "description": "Read, modify, execute, and convert Jupyter notebooks programmatically. Use when working with .ipynb files for data science workflows, including editing cells, clearing outputs, or converting to oth...",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "jupyter",
+    "notebook",
+    "ipynb",
+    "data-science"
+  ]
+}

package/skills/jupyter/.codex-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+  "name": "jupyter",
+  "version": "1.0.0",
+  "description": "Read, modify, execute, and convert Jupyter notebooks programmatically. Use when working with .ipynb files for data science workflows, including editing cells, clearing outputs, or converting to oth...",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "jupyter",
+    "notebook",
+    "ipynb",
+    "data-science"
+  ]
+}

package/skills/kubernetes/.claude-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+  "name": "kubernetes",
+  "version": "1.0.0",
+  "description": "Set up and manage local Kubernetes clusters using KIND (Kubernetes IN Docker). Use when testing Kubernetes applications locally or developing cloud-native workloads.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "kubernetes",
+    "k8s",
+    "kind",
+    "cloud-native"
+  ]
+}

package/skills/kubernetes/.codex-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+  "name": "kubernetes",
+  "version": "1.0.0",
+  "description": "Set up and manage local Kubernetes clusters using KIND (Kubernetes IN Docker). Use when testing Kubernetes applications locally or developing cloud-native workloads.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "kubernetes",
+    "k8s",
+    "kind",
+    "cloud-native"
+  ]
+}

package/skills/learn-from-code-review/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "learn-from-code-review",
+  "version": "1.0.0",
+  "description": "Distill code review feedback from GitHub PRs into reusable skills and guidelines. Use when users ask to learn from code reviews, extract review patterns, or generate coding standards from historica...",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "code-review",
+    "learning",
+    "skills",
+    "guidelines",
+    "pr-feedback"
+  ]
+}

package/skills/learn-from-code-review/.codex-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "learn-from-code-review",
+  "version": "1.0.0",
+  "description": "Distill code review feedback from GitHub PRs into reusable skills and guidelines. Use when users ask to learn from code reviews, extract review patterns, or generate coding standards from historica...",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "code-review",
+    "learning",
+    "skills",
+    "guidelines",
+    "pr-feedback"
+  ]
+}

package/skills/linear/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "linear",
+  "version": "1.0.0",
+  "description": "Interact with Linear project management - query issues, update status, create tickets using the Linear GraphQL API.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "linear",
+    "ticket",
+    "issue",
+    "project-management",
+    "graphql"
+  ]
+}

package/skills/linear/.codex-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "linear",
+  "version": "1.0.0",
+  "description": "Interact with Linear project management - query issues, update status, create tickets using the Linear GraphQL API.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "linear",
+    "ticket",
+    "issue",
+    "project-management",
+    "graphql"
+  ]
+}

package/skills/linear-triage/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "linear-triage",
+  "version": "1.0.0",
+  "description": "Create an automation that triages new Linear issues by inspecting title, description, team, and recent related issues. Suggests labels, priority, likely owner, and potential duplicates, then posts a clarifying comment.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "linear",
+    "triage",
+    "issues",
+    "labels",
+    "priority",
+    "automation",
+    "integration"
+  ]
+}

package/skills/linear-triage/.codex-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "linear-triage",
+  "version": "1.0.0",
+  "description": "Create an automation that triages new Linear issues by inspecting title, description, team, and recent related issues. Suggests labels, priority, likely owner, and potential duplicates, then posts a clarifying comment.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "linear",
+    "triage",
+    "issues",
+    "labels",
+    "priority",
+    "automation",
+    "integration"
+  ]
+}

package/skills/news-digest/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "news-digest",
+  "version": "1.0.0",
+  "description": "Create an automation that reads public RSS and Atom feeds on a schedule, keeps what is new and matches the configured topics, and has an agent write a short digest of it. Needs no credentials.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "news",
+    "rss",
+    "atom",
+    "digest",
+    "automation"
+  ]
+}

package/skills/news-digest/.codex-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "news-digest",
+  "version": "1.0.0",
+  "description": "Create an automation that reads public RSS and Atom feeds on a schedule, keeps what is new and matches the configured topics, and has an agent write a short digest of it. Needs no credentials.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "news",
+    "rss",
+    "atom",
+    "digest",
+    "automation"
+  ]
+}

package/skills/notion/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "notion",
+  "version": "1.0.0",
+  "description": "Create, search, and update Notion pages/databases using the Notion API. Use for documenting work, generating runbooks, and automating knowledge base updates.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "notion",
+    "documentation",
+    "knowledge-base"
+  ]
+}

package/skills/notion/.codex-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "notion",
+  "version": "1.0.0",
+  "description": "Create, search, and update Notion pages/databases using the Notion API. Use for documenting work, generating runbooks, and automating knowledge base updates.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "notion",
+    "documentation",
+    "knowledge-base"
+  ]
+}

package/skills/npm/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "npm",
+  "version": "1.0.0",
+  "description": "Handle npm package installation in non-interactive environments by piping confirmations. Use when installing Node.js packages that require user confirmation prompts.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "npm",
+    "nodejs",
+    "packages"
+  ]
+}

package/skills/npm/.codex-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "npm",
+  "version": "1.0.0",
+  "description": "Handle npm package installation in non-interactive environments by piping confirmations. Use when installing Node.js packages that require user confirmation prompts.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "npm",
+    "nodejs",
+    "packages"
+  ]
+}

package/skills/openhands-api/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "openhands-api",
+  "version": "1.0.0",
+  "description": "Use the OpenHands Cloud REST API (V1) to create and manage app conversations, including multi-conversation delegation workflows, and to access sandbox agent-server endpoints. Includes minimal Pytho...",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "openhands",
+    "api",
+    "cloud",
+    "automation",
+    "delegation",
+    "agent-server",
+    "sandbox",
+    "conversations"
+  ]
+}

package/skills/openhands-api/.codex-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "openhands-api",
+  "version": "1.0.0",
+  "description": "Use the OpenHands Cloud REST API (V1) to create and manage app conversations, including multi-conversation delegation workflows, and to access sandbox agent-server endpoints. Includes minimal Pytho...",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "openhands",
+    "api",
+    "cloud",
+    "automation",
+    "delegation",
+    "agent-server",
+    "sandbox",
+    "conversations"
+  ]
+}

package/skills/openhands-automation/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "openhands-automation",
+  "version": "1.0.0",
+  "description": "Create and manage OpenHands automations - scheduled tasks that run in sandboxes. Use the prompt preset to create automations from natural language, or manage existing automations.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "automation",
+    "cron",
+    "scheduled-task",
+    "sandbox",
+    "openhands"
+  ]
+}

package/skills/openhands-automation/.codex-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "openhands-automation",
+  "version": "1.0.0",
+  "description": "Create and manage OpenHands automations - scheduled tasks that run in sandboxes. Use the prompt preset to create automations from natural language, or manage existing automations.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "automation",
+    "cron",
+    "scheduled-task",
+    "sandbox",
+    "openhands"
+  ]
+}

package/skills/openhands-automation/README.md

@@ -26,7 +26,7 @@ This skill is activated by keywords:
 
 ## API Base URL
 
-All automation endpoints are at: `https://app.all-hands.dev/api/automation/v1`
+Use an explicitly provided host first. When a local Agent Canvas automation server is running and no host is provided, use `http://localhost:8001/api/automation/v1`. Otherwise use the cloud default: `https://app.all-hands.dev/api/automation/v1`.
 
 ## Quick Start
 

package/skills/openhands-automation/SKILL.md

@@ -48,7 +48,7 @@ The agent server typically runs inside a **sandbox** (a Docker or Kubernetes con
 |---|---|---|
 | `RUNTIME_URL` | Ambient in cloud environments | Public-facing URL of the **agent server** sandbox. Use this to determine whether external webhook delivery is possible — if unset or local, webhooks cannot be received. The automation service may run at a separate URL (see Determining the API Host). |
 | `AGENT_SERVER_URL` | Injected into scripts at run time only | Internal URL of the agent server. Available inside script execution context; **not** an ambient environment variable outside of a running script. |
-| `OPENHANDS_HOST` | Shell convention only — set manually | Base URL for the automation service API. **Not a real environment variable.** Set it from the `<HOST>` system-prompt value, or default to `https://app.all-hands.dev`. Used in all `curl` examples throughout this skill. |
+| `OPENHANDS_HOST` | Shell convention only — set manually | Base URL for the automation service API. **Not a real environment variable.** Set it from an explicit host, a detected local Agent Canvas server, or the cloud default. Used in all `curl` examples throughout this skill. |
 
 > **⚠️ CRITICAL — Agent behavior rules:**
 >
@@ -113,11 +113,17 @@ Entrypoint must be `python3 main.py` (no `setup.sh` needed). Wrap your main logi
 
 ## Authentication
 
-All requests require Bearer authentication:
+All requests require authentication:
 
-```bash
--H "Authorization: Bearer ${OPENHANDS_API_KEY}"
-```
+- Cloud (default `https://app.all-hands.dev`): Bearer token:
+
+  `-H "Authorization: Bearer ${OPENHANDS_API_KEY}"`
+
+- Local Agent Canvas (`http://localhost:8001`): session API key through `X-Session-API-Key`:
+
+  `-H "X-Session-API-Key: ${OPENHANDS_AUTOMATION_API_KEY:-${SESSION_API_KEY}}"`
+
+The curl examples below show cloud Bearer authentication. For local Agent Canvas, replace that header with the `X-Session-API-Key` header above.
 
 ## API Endpoints
 
@@ -127,14 +133,18 @@ All requests require Bearer authentication:
 
 The automation service may run at a different URL from the agent server. In the examples throughout this skill, `${OPENHANDS_HOST}` is a shell-variable convention for the automation service base URL — it is **not** a real environment variable. Set it from context before running any curl command:
 
-- Look for a `<HOST>` value in the system prompt. If present, use that URL.
+- Look for a `<HOST>` value in the system prompt or runtime-services block. If present, use that URL.
+- If running inside a local Agent Canvas stack and no explicit host is provided, use `http://localhost:8001` for the local automation/agent-server API.
 - Otherwise default to `https://app.all-hands.dev`.
 
+For a local Agent Canvas server, validate the endpoint before making a mutating request and authenticate with the session key through `X-Session-API-Key` when that API requires it. Do not use the cloud default merely because no `<HOST>` value is present.
+
 ```bash
-OPENHANDS_HOST="https://app.all-hands.dev"  # replace with <HOST> if provided
+# Choose the host that matches the detected environment:
+OPENHANDS_HOST="http://localhost:8001"       # local Agent Canvas
+# OPENHANDS_HOST="https://app.all-hands.dev" # OpenHands Cloud
 ```
 
-
 ### Automation Endpoints
 
 | Endpoint | Method | Description |

package/skills/openhands-enterprise-troubleshooting/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "openhands-enterprise-troubleshooting",
+  "version": "1.0.0",
+  "description": "Diagnose and resolve common issues on OpenHands Enterprise self-hosted installations. Covers sandbox startup failures, auth issues, certificate errors, LLM connectivity, Keycloak login, Replicated Admin Console access, upgrade failures, and resource exhaustion. Includes support bundle generation, offline bundle analysis with a bundled triage script, and escalation handoffs.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "openhands",
+    "enterprise",
+    "troubleshooting",
+    "replicated",
+    "support-bundle",
+    "kubernetes"
+  ]
+}

package/skills/openhands-enterprise-troubleshooting/.codex-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "openhands-enterprise-troubleshooting",
+  "version": "1.0.0",
+  "description": "Diagnose and resolve common issues on OpenHands Enterprise self-hosted installations. Covers sandbox startup failures, auth issues, certificate errors, LLM connectivity, Keycloak login, Replicated Admin Console access, upgrade failures, and resource exhaustion. Includes support bundle generation, offline bundle analysis with a bundled triage script, and escalation handoffs.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "openhands",
+    "enterprise",
+    "troubleshooting",
+    "replicated",
+    "support-bundle",
+    "kubernetes"
+  ]
+}

package/skills/openhands-enterprise-troubleshooting/.plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "openhands-enterprise-troubleshooting",
+  "version": "1.0.0",
+  "description": "Diagnose and resolve common issues on OpenHands Enterprise self-hosted installations. Covers sandbox startup failures, auth issues, certificate errors, LLM connectivity, Keycloak login, Replicated Admin Console access, upgrade failures, and resource exhaustion. Includes support bundle generation, offline bundle analysis with a bundled triage script, and escalation handoffs.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "openhands",
+    "enterprise",
+    "troubleshooting",
+    "replicated",
+    "support-bundle",
+    "kubernetes"
+  ]
+}