Handlus plugins

Skills for AI agents that use your own browser (Chrome, Edge, Whale) and computer through Handlus, packaged for Claude Code and Codex.

Skill	What it does
handlus-browser	When a task needs a step on a website (getting an API key from a service's dashboard, changing a console setting) and no connected tool covers it, the agent does it in your signed-in browser instead of installing a CLI or handing it back to you.
handlus-computer	When the work is in a desktop program (an order or accounting program, Notepad, Excel, Calculator), the agent reads the window, enters what is needed and reads it back, through the Handlus app on your Mac or Windows PC.
recording-chrome-fake-cursor	Records one Chrome window on macOS or Windows while the agent drives it, with a visible fake cursor that glides, clicks with an orange ripple and types letter by letter. Your real mouse never moves. On a Mac the Handlus app does the recording.

Install

Claude Code

/plugin marketplace add handlus/plugins
/plugin install handlus@handlus

Then ask: "Record a demo of handlus.com with the fake cursor." The skill is /handlus:recording-chrome-fake-cursor.

Codex

codex plugin marketplace add handlus/plugins
codex plugin add handlus@handlus

To add only the skill, copy plugins/handlus/skills/recording-chrome-fake-cursor into ~/.codex/skills/.

Connect Handlus (once)

The skills drive your browser through the Handlus MCP server. Install the Handlus extension from handlus.com, then:

claude mcp add --transport http --scope user handlus https://api.handlus.com/mcp   # Claude Code
codex mcp add handlus --url https://api.handlus.com/mcp                             # Codex

The fake cursor (chrome_demo_cursor) needs Handlus extension 0.3.1 or later. With older versions or other Chrome MCPs the skill falls back to injecting scripts/cursor.js.

Set up recording (macOS, once)

On a Mac the Handlus app (1.5.0 or later) records the window, so the terminal or editor running the agent needs no permission and nothing has to be built.

1. Install the Handlus app from handlus.com/download. Or ask your agent: "Set up recording." The skill runs scripts/setup.sh install, which downloads the app and opens it.
2. Connect this computer on the page that opens in your browser.
3. On the app window's setup screen, turn on Allow, Accessibility and Screen Recording. If macOS asks to quit and reopen Handlus, do it: only the Handlus app restarts.

Requirements in short: macOS 13+, the Handlus app 1.5.0+, Google Chrome. ffmpeg and python3 with Pillow are optional, only to trim the video or make a preview sheet. Check any time with zsh <skill folder>/scripts/setup.sh, or have your agent call desktop_list (this Mac should show [on]).

Set up recording (Windows, once)

Ask your agent: "Set up recording." On Windows the skill runs scripts/setup.ps1 (through powershell -NoProfile -ExecutionPolicy Bypass -File), tells you what is missing and installs it for your user, without administrator rights:

• ffmpeg (to encode the video), downloaded into the skill's scripts\bin\ffmpeg. The window itself is captured with Windows.Graphics.Capture, built into Windows, with or without a graphics card
• Python 3 (winget, or the python.org installer) and Pillow

There is no permission to turn on and nothing to restart. Requirements in short: Windows 10 version 2004 or later / Windows 11, Google Chrome, PowerShell 5.1 (built in). Run the agent on Windows itself (Claude Code in Git Bash or PowerShell, Codex); WSL is not supported for recording. Check any time with powershell -NoProfile -ExecutionPolicy Bypass -File <skill folder>\scripts\setup.ps1.

---

한국어

Handlus(내 브라우저(크롬 · 엣지 · 웨일)와 컴퓨터를 AI 에이전트가 쓰게 하는 MCP)용 스킬을 클로드코드 · 코덱스 플러그인으로 묶었습니다.

• 웹 일 스킬 handlus-browser — 대시보드에서 API 키 발급, 콘솔 설정 바꾸기처럼 웹에서 하는 일을, 맡을 도구가 연결돼 있지 않으면 CLI 를 깔거나 나에게 넘기지 않고 내 브라우저에서 합니다.
• 컴퓨터 스킬 handlus-computer — 주문 · 회계 프로그램, 메모장, 엑셀, 계산기처럼 브라우저 밖 PC 프로그램에서 하는 일을 Handlus 앱으로 합니다. 창을 먼저 읽고, 입력하고, 다시 읽어 확인합니다(맥 · 윈도우, handlus.com/download 에서 앱 설치).
• 녹화 스킬 recording-chrome-fake-cursor — 에이전트가 크롬을 조작하는 모습을 그 창만 녹화합니다. 가짜 커서가 움직이고, 누를 때 주황 원이 퍼지고, 글자가 한 자씩 쳐집니다. 진짜 마우스는 움직이지 않습니다(맥 · 윈도우). 맥에서는 Handlus 앱이 녹화합니다.
• 클로드코드: /plugin marketplace add handlus/plugins → /plugin install handlus@handlus
• 코덱스: codex plugin marketplace add handlus/plugins → codex plugin add handlus@handlus. 스킬만 쓰려면 스킬 폴더를 ~/.codex/skills/ 에 복사
• Handlus 연결은 위 명령 한 줄. 가짜 커서 도구는 Handlus 확장 0.3.1 이상에서 됩니다.
• 녹화 준비(맥, 한 번): 맥에서는 Handlus 앱(1.5.0 이상)이 창을 녹화합니다. 에이전트를 돌리는 터미널 · 편집기에는 권한이 필요 없고, 따로 빌드할 것도 없습니다. handlus.com/download 에서 앱을 설치하고(에이전트에게 「녹화 준비해 줘」 라고 하면 스킬이 scripts/setup.sh install 로 받아 엽니다), 브라우저에 열리는 페이지에서 이 컴퓨터를 연결한 뒤, 앱 창의 준비 화면에서 「허용」 · 「손쉬운 사용」 · 「화면 기록」 을 켭니다. 맥이 Handlus 를 다시 열라고 하면 그대로 하면 됩니다(Handlus 앱만 다시 켜집니다). ffmpeg · 파이썬(Pillow)은 영상을 자르거나 미리보기 시트를 만들 때만 씁니다.
• 녹화 준비(윈도우, 한 번): 「녹화 준비해 줘」 라고 하면 스킬이 scripts/setup.ps1 로 점검하고, 영상을 만드는 ffmpeg(스킬 폴더 scripts\bin\ffmpeg 에 받음) · 파이썬 3 · Pillow 를 관리자 권한 없이 내 사용자 계정에 설치합니다. 켤 권한도, 다시 열 앱도 없습니다. 윈도우 10 2004 이상 · 11, 크롬이 필요하고, 에이전트는 윈도우에서 바로 돌려야 합니다(WSL 안에서는 녹화가 안 됩니다).

Copyright (c) 2026 Handlus. See LICENSE.