Connect OpenHands to Your AI Agent

Start OpenHands Cloud repository conversations, inspect start-task and conversation status, and send follow-up messages. Ask your connected AI assistant to explain the results or carry out the specified operation.

5 tools API key

Connect OpenHands Install OOMOL

Try a OpenHands Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill OpenHands

Start a Repository Investigation

Submit a clear task for a selected repository and branch.

/oo OpenHands: Start an OpenHands conversation for repository [owner/repo], branch [branch], with message [investigation instructions], run true, and inspect the returned start task.

Continue a Conversation

Read current conversation metadata and send a precise additional instruction.

/oo OpenHands: Read OpenHands conversation [conversation ID], then send [follow-up instructions] with run true.

Start Working with OpenHands

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect OpenHands

Connect with an OpenHands Cloud API key from Settings > API Keys.
Connect OpenHands →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

OpenHands Cloud API access and access to the selected repository.
Starting a conversation may return a start-task ID. Inspect that task and the resulting conversation; submission does not establish code completion.

OpenHands Tools

OpenHands connects supported service operations to your AI assistant. Start OpenHands Cloud repository conversations, inspect start-task and conversation status, and send follow-up messages.

Conversation Start

Create a repository-task conversation and inspect its start task.

Conversation Follow-up

List and read conversations and send additional user instructions.

5 tools

Start Conversation

Start an OpenHands Cloud conversation for a repository task.

open_hands.start_conversation

Get Start Task

Get the status of an OpenHands Cloud conversation start task.

open_hands.get_start_task

Get Conversation

Get an OpenHands Cloud conversation by ID.

open_hands.get_conversation

List Conversations

List OpenHands Cloud conversations with optional filters.

open_hands.list_conversations

Send Message

Send a follow-up user message to an existing OpenHands Cloud conversation.

open_hands.send_message

Frequently Asked Questions

What repository format should I use?

Supply selected_repository in owner/repo format and specify the intended branch.

Does starting a task prove code is ready?

No. Inspect the start task and conversation status, then review actual work results before relying on them.

Can I continue an existing conversation?

Yes. Supply its conversation ID and a follow-up message, choosing whether to run the agent.