Harumi

Agent skill

Install the harumi-cli agent skill for Cursor, Claude Code, and other coding agents — it can install and drive the CLI for you.

Overview

Alongside the CLI itself, Harumi ships two agent skillsSKILL.md files that teach a coding agent (Cursor, Claude Code, Codex, and others) how to install, authenticate, and use the harumi CLI:

SkillWhat it does
harumi-cli-setupInstalls/upgrades the CLI, walks you through login, picks the backend environment, and diagnoses a broken install.
harumi-cliDrives the CLI once it works — running code, managing projects, repos, runs, datasources, schedules, secrets, and organizations.

You don't need the CLI installed first. Install the skill, then just ask your agent to install the CLI — harumi-cli-setup handles the rest, including picking an install method and handing the interactive login step back to you.

Both skills are published from harumi-io/harumi-skills, mirrored automatically from the canonical copy in harumi-cli's .agents/skills/ on every release.

Install

Works with Cursor, Claude Code, Codex, GitHub Copilot, and most other coding agents — npx skills auto-detects which ones you have and writes to the right directory for each:

npx skills add harumi-io/harumi-skills          # detected agents, project scope
npx skills add harumi-io/harumi-skills -g       # global scope (~/), every project

Not sure which one your agent uses?

npx skills add harumi-io/harumi-skills --list prints both skills without installing anything, and npx skills list shows what's already installed across every agent it recognizes on your machine.

Use it

Once installed, just describe what you want in your agent's chat — both skills are model-invoked, so phrasing like the following triggers them automatically:

Install the harumi CLI and log me in.
harumi: command not found — can you fix that?
Use the harumi CLI to run this solver script on Harumi's infrastructure.

You can also invoke a skill directly (Claude Code: /harumi-cli-plugin:harumi-cli-setup; Cursor: /harumi-cli-setup).

The CLI's interactive login (harumi login) emails a one-time code and needs you at the keyboard — the setup skill will ask you to run it yourself rather than trying to automate it.

Next steps

On this page