Skip to content

openhands.md

Latest commit

 

History

History
62 lines (45 loc) · 1.76 KB

openhands.md

File metadata and controls

62 lines (45 loc) · 1.76 KB
Raw

Watch Skill in OpenHands

OpenHands avatars inspecting a frame under a desk lamp

Status: doc-verified ☑ — config matches the official OpenHands MCP docs; not executed here.

Install

uvx --from "watch-skill[standard]" watch-skill doctor

uvx fetches the package on first use and needs no checkout. Prefer a permanent install? pipx install "watch-skill[standard]", then use "command": "watch-skill", "args": ["serve"] in the config below.

From source instead (contributors) 
git clone https://github.com/oxbshw/watch-skill && cd watch-skill
uv sync --extra all
uv run watch-skill doctor

Then run watch-skill setup, which writes the config pointing at your checkout rather than the published package.

Configure

OpenHands takes stdio MCP servers in config.toml under [mcp] (or Settings → MCP in the UI):

[mcp]
stdio_servers = [
    {name="watch-skill", command="uvx", args=["--from", "watch-skill[standard]", "watch-skill", "serve"]}
]

OpenHands' docs recommend MCP proxies for production reliability; direct stdio is their documented path for local single-user setups, which is exactly what a local video index is.

Smoke test (3 steps)

  1. Start a conversation: "Watch https://www.youtube.com/watch?v=aqz-KE-bpKQ and tell me what happens at 0:10."
  2. Approve the watch_video call.
  3. Follow up: "what color is the bird?" — should call ask_video, no re-processing.

Notes

  • OpenHands often runs the agent inside a sandboxed runtime. The index lives under ~/.watch-skill/ of whatever environment runs the server — if the runtime is ephemeral, mount that path or the memory resets with the sandbox.