기본 콘텐츠로 건너뛰기

CLI-Anything Tutorial: Give Coding Agents a CLI for Any App

Summary: CLI-Anything is an open-source (Apache-2.0) project from HKUDS that wraps desktop apps and services in command-line interfaces built for AI agents, with JSON output and a REPL. You can install ready-made CLIs from its CLI-Hub registry with one pip package, let Claude Code or Codex discover them through a skill, or generate a new CLI for an app that is not listed yet. We installed CLI-Hub on a Linux box, built a small draw.io diagram entirely from the terminal, and hit one real gotcha you should know about before you rely on it.

What CLI-Anything actually gives your agent

Coding agents such as Claude Code and Codex are very good at running shell commands and reading text output, and much weaker at clicking through a GUI. CLI-Anything takes that at face value: instead of screenshots and mouse clicks, each supported app gets a command such as cli-anything-drawio or cli-anything-blender. Every command has --help text the agent can read, and a --json flag so the result comes back as structured data instead of prose.

The project is organised in three layers, and it helps to keep them apart:

  • Harnesses: the per-app CLIs (GIMP, Blender, Inkscape, LibreOffice, FreeCAD, draw.io, OBS Studio, n8n and many more), each in its own <app>/agent-harness folder in the repository.
  • CLI-Hub: a small package manager (cli-hub) plus the website clianything.cc that lists every harness and a set of third-party "public" CLIs.
  • The generator: a plugin or skill for your coding agent that runs a 7-phase process to build a new harness from an app's source code.

The README is explicit that the CLIs drive the real software: a Blender harness renders through blender --background, not through a lookalike renderer. That is good for output quality, but it also means the app itself must be installed, which matters later in this tutorial.

Step 1: Install CLI-Hub and look around

CLI-Hub is a normal Python package. We used a fresh virtual environment so nothing leaks into the system Python:

python3 -m venv venv
. venv/bin/activate
pip install cli-anything-hub

On our run (19 November 2026) pip installed version 0.4.1. The main commands are:

  • cli-hub list shows the registry grouped by category (3D, AI, audio, automation, diagrams and so on). cli-hub list --json returned 103 entries for us: 79 harnesses maintained in the repo and 24 public third-party CLIs, which matches the "103 CLIs available, 35 categories" counter on clianything.cc.
  • cli-hub search diagram returned drawio, mermaid and an Obsidian CLI.
  • cli-hub info <name> prints the version, entry point, the bundled SKILL.md path and, most importantly, the Requires line.
  • cli-hub install, update, uninstall and launch do what they say.

Read the Requires line before you install anything. For the three apps people ask about most, CLI-Hub reported: draw.io needs the draw.io desktop app; Blender needs blender >= 4.2; FreeCAD needs FreeCAD >= 1.1 (its harness lists 258 commands across Part, Sketcher, PartDesign, Assembly, Mesh, TechDraw, Draft, FEM and CAM).

Step 2: One real task with the draw.io CLI

We picked draw.io because the diagram file is plain XML, so we could check what the harness does without a GPU or a big install. After cli-hub install drawio the entry point cli-anything-drawio was on the path. Its top-level groups are project, page, shape, connect, export, session and repl.

Create a project and add shapes

cli-anything-drawio --json project new --preset 16:9 -o flow.drawio
cli-anything-drawio --json --project flow.drawio shape add rounded -l "Agent prompt" --x 40 --y 80 --id a
cli-anything-drawio --json --project flow.drawio shape add process -l "cli-hub install drawio" --x 260 --y 80 --id b
cli-anything-drawio --json --project flow.drawio connect add a b --style orthogonal
cli-anything-drawio --json --project flow.drawio shape list

Each call answered with a short JSON object, for example {"action": "add_connector", "source": "a", "target": "b", "style": "orthogonal"}, and shape list returned every shape with its id, label, style string and coordinates. Setting your own --id values is worth the extra typing: the agent can then connect shapes by name instead of copying generated ids around. Shape types include rectangle, rounded, ellipse, diamond, cylinder, cloud, process, document, note, actor and text.

Export, and the gotcha

The export formats listed were PDF, PNG, SVG, VSDX (Visio) and uncompressed XML. Exporting to XML worked straight away (a 1,648-byte file). Exporting to PNG did not fail with a crash; it returned "action": "export_fallback" with the note "draw.io CLI not found. Open the .drawio file in draw.io to export manually." plus install hints for macOS, Linux and Windows. In other words, editing works with no desktop app, but rendering images needs draw.io desktop on the same machine. An agent that only checks the exit code could miss this, so tell it to read the JSON action field.

Our full terminal session is in our own screenshot at the end of this post.

Step 3: Let Claude Code or Codex find CLIs on its own

Installing CLIs by hand is fine for a test. For daily use the project ships a "meta-skill" that teaches a SKILL-compatible agent to search CLI-Hub and install what a task needs:

npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y

The README lists OpenClaw, Nanobot, Claude Code, Codex, Reasonix and Antigravity as compatible, and suggests a prompt of the form "Find appropriate CLI software in CLI-Hub and complete the task: ...". If you have not used skills before, our guide to one SKILL.md for Claude Code, Cursor and Copilot explains how they load. Every harness also ships its own SKILL.md (CLI-Hub shows the path in info), so an agent can read the command reference before it starts.

Step 4: Generate a CLI for an app that is not listed

When the registry has nothing for your app or internal tool, the generator builds a new harness. Prerequisites per the README: Python 3.10+, the target software or its source repo, and a supported agent.

Claude Code

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything
/cli-anything ./gimp

Follow-ups use the colon form: /cli-anything:refine ./gimp "batch processing and filters" expands coverage, and /cli-anything:validate checks a harness against the project's standards. If Claude Code says Unknown skill: cli-anything, the README's advice is to fix the plugin load first (/reload-plugins, then /help cli-anything, then reinstall) rather than switching command forms. On Windows it needs Git for Windows or WSL, otherwise you may see cygpath: command not found.

Codex

Codex support is marked experimental. You clone the repository and run bash CLI-Anything/codex-skill/scripts/install.sh (or install.ps1 on Windows), which installs the skill to ~/.codex/skills/cli-anything when CODEX_HOME is unset. Restart Codex, then ask in plain language, for example "Use CLI-Anything to build a harness for ./gimp".

We did not run the generator in this test, so we cannot speak to output quality. The README's own limitations section is candid: it expects frontier-class models, it works from source code (binaries-only apps degrade a lot), and one pass often needs extra /refine runs.

Which entry point should you use?

Option How you start Cost Good for Main limit
CLI-Hub (manual) pip install cli-anything-hub, then cli-hub install <name> Free, Apache-2.0 Trying one of the 103 listed CLIs yourself Many harnesses need the real app installed (draw.io desktop, Blender 4.2+, FreeCAD 1.1+)
CLI-Hub meta-skill npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y Free; your agent's own model usage applies Letting Claude Code, Codex and other skill-aware agents pick a CLI per task The agent installs packages for you, so review what it pulls
Generator plugin/skill Claude Code: /plugin install cli-anything; Codex: install.sh (experimental) Free; generation uses your agent's model Internal tools and apps not in the registry Needs source code and a strong model; expect several /refine passes

Editor's note

Who it's for: people already running Claude Code, Codex or a similar agent who want it to produce real files in desktop tools (diagrams, 3D scenes, documents, audio edits) without GUI automation. It also suits teams with an in-house tool that has source code but no API.

Not for: anyone hoping to skip installing the underlying apps, or wanting a hosted service. Everything runs on your machine.

Gotchas we hit or verified: (1) Check cli-hub info for the Requires line first. (2) Without draw.io desktop, PNG/PDF export quietly falls back to writing a .drawio file; parse the JSON action field, not just the exit code. (3) The CLI is stateful through a project file or --session, so pass --project on every one-shot call or use the REPL. (4) On Windows, Claude Code needs Git for Windows or WSL for the plugin's shell steps.

Common errors and fixes: Unknown skill: cli-anything means the plugin is not loaded: run /reload-plugins and check /help cli-anything. cygpath: command not found on Windows means bash is missing: install Git for Windows or use WSL.

How it fits with other agent tooling

CLI-Anything sits next to, not instead of, MCP servers. Some harnesses even bridge to MCP (the browser harness uses DOMShell MCP, and the ArcGIS Pro demo drives a live session through an MCP bridge). If your target is a web page rather than a desktop app, a dedicated tool may serve better; see our Chrome DevTools MCP tutorial. For cloud work, our AWS emulator tutorial for coding agents covers the same "give the agent a safe, scriptable surface" idea for AWS.

FAQ

Is CLI-Anything free?

Yes. The repository and CLI-Hub are under the Apache License 2.0. What you pay for is whatever model your agent uses and any licence the wrapped app itself requires.

Do I need Blender or draw.io installed to use their CLIs?

For real output, yes. CLI-Hub lists Blender 4.2 or newer and the draw.io desktop app as requirements. In our draw.io test, editing the diagram file worked without the app, but image export did not.

Can it build a CLI for a closed-source app?

Only with a big drop in quality, according to the README: the generator analyses source code, and binaries-only apps degrade substantially. Packaging APIs for closed-source software is listed on the roadmap.

Start with one listed CLI and one small task, and let your agent read the JSON before you trust it with bigger jobs.

Images: our own screenshots of clianything.cc and the CLI-Anything GitHub README, plus our own terminal capture and summary table; see them at the end of this post.

Last verified: 2026-11-19
Sources: CLI-Anything on GitHub (README), CLI-Hub (clianything.cc), cli-anything-hub on PyPI, and our own test run of cli-anything-hub 0.4.1 with the drawio harness 1.0.0.
lightmind24 is an independent review site, not affiliated with HKUDS or the CLI-Anything project.

Uploaded Image Uploaded Image Uploaded Image Uploaded Image Uploaded Image

댓글

이 블로그의 인기 게시물

브루(Vrew) 요금제 정리: 무료 200크레딧으로 어디까지 쓸 수 있나

요약: 영상 자막 편집기 브루(Vrew)는 2026년 4월 22일부터 기능별 사용량 대신 '통합 크레딧' 하나로 요금을 매겨요. 무료 플랜은 매달 200크레딧이 들어오는데, 음성 분석(자동 자막)만 쓰면 최대 200분 분량이라 짧은 영상 몇 편은 충분하지만, 영상 초반의 Vrew 마크를 지우려면 유료 플랜이 필요해요. 이 글은 브루 공식 가격 페이지와 고객센터 공지를 2026년 10월 23일에 다시 확인해, 크레딧 계산법과 플랜 고르는 기준을 정리했어요. 목차 브루 요금 구조: 통합 크레딧이란 1크레딧으로 할 수 있는 일 무료 플랜으로 되는 것과 안 되는 것 유료 플랜 4종 비교표 월 구독·연 구독·기간 이용권, 무엇이 이득일까 상황별 추천: 학생·직장인·유튜버 크레딧이 모자랄 때: 사용 기록 지우개 업그레이드·환불 전에 알아둘 규칙 운영자 메모, 자주 묻는 질문 1. 브루 요금 구조: 통합 크레딧이란 예전 브루는 플랜마다 음성 분석 몇 분, AI 목소리 몇 자, 번역 몇 자처럼 기능별 한도를 따로 줬어요. 그런데 보이저엑스(브루 운영사)가 실제 이용 데이터를 보니 한두 가지 기능만 집중해서 쓰는 사람이 훨씬 많았다고 해요. 그래서 2026년 4월 22일 업데이트부터는 플랜마다 정해진 크레딧을 받고, 어떤 기능에 쓸지는 내가 정하는 방식으로 바뀌었어요. 플랜별 매달 지급량은 Free 200 · Light 2,000 · Standard 10,000 · Business 12,000크레딧 이에요. 공식 공지에 따르면 무료 사용자는 매달 1일에, 유료 사용자는 매월 결제일에 충전되고, 남은 크레딧은 다음 달로 넘어가지 않아요. 바뀐 뒤 무엇이 좋아졌나 공지에 나온 예시가 이해하기 쉬워요. Standard 플랜에서 AI 목소리만 쓰면 예전에는 최대 50만 자였지만, 지금은 1만 크레딧을 모두 AI 목소리에 몰아 쓸 수 있어 최대 100만 자가 돼요. 반대로 여러 기능을 골고루 쓰는 사람은 크레딧이 기능끼리 ...

에이닷 전화 vs 익시오: 통화 녹음·AI 요약, 내 통신사·폰에 맞는 앱 고르기

요약: 통화 녹음과 AI 요약을 쓰고 싶다면 먼저 내 통신사와 휴대폰 종류부터 확인해야 해요. LG유플러스 고객은 무료 앱 익시오, SKT 고객은 에이닷 전화가 가장 기능이 많고, 다른 통신사의 아이폰 사용자는 iOS에 들어 있는 기본 통화 녹음·전사 기능이 현실적인 선택이에요. 이 글은 2026-10-30에 SKT·LG유플러스·Apple 공식 페이지와 도움말을 직접 확인해 세 가지를 비교했어요. 왜 '앱 기능'보다 '내 조건'을 먼저 봐야 할까요 통화 요약 앱 비교 글을 보면 기능 목록부터 나열하는 경우가 많아요. 그런데 실제로 써 보려는 사람에게 가장 먼저 걸리는 건 기능이 아니라 이용 조건 이에요. 익시오는 LG유플러스 고객 전용이고, 에이닷 전화는 누구나 설치할 수 있지만 통역콜·baro 같은 기능은 SKT 고객에게만 열려 있어요. 아이폰은 운영체제 구조상 앱이 통화를 마음대로 녹음하기 어려워서, 통신사 앱이 안 되면 iOS 기본 기능에 기대야 해요. 그래서 이 글은 "어떤 앱이 제일 좋은가"보다 "내 통신사·내 폰에서 무엇을 쓸 수 있나" 순서로 정리했어요. 기능 차이는 그다음이에요. 한눈에 비교: 에이닷 전화 vs 익시오 vs 아이폰 기본 통화 녹음 구분 에이닷 전화 (SKT) 익시오 ixi-O (LG유플러스) 아이폰 기본 통화 녹음 (Apple) 누가 쓸 수 있나 통신사 구분 없이 앱 설치 가능. 단, 통역콜·baro·그룹통화 발신 등은 SKT 고객 전용 U+ 모바일 고객. 타 통신사, 만 14세 미만, 선불요금제 고객은 제한 (공식 사이트 FAQ상 알뜰폰 중 KB리브엠은 예외) 지원 국가·언어의 iPhone 사용자. 1명과 통화할 때만 녹음 가능 지원 OS·기기 Android 10 이상, iOS 16 이상 iOS 17 이상 iPhone 12 이상 / Android...

타입캐스트 vs 클로바더빙: 수익 나는 채널에 쓸 때 무료·유료 조건 비교

요약 타입캐스트와 클로바더빙은 둘 다 글만 입력하면 한국어 AI 목소리를 만들어 주는 서비스지만, 무료로 쓸 수 있는 범위가 꽤 다릅니다. 클로바더빙 무료는 매달 15,000자까지 쓸 수 있는 대신 수익이 생기는 채널에는 쓸 수 없고, 타입캐스트 무료는 처음에 주는 약 5분 분량의 다운로드로 끝나는 체험판에 가깝습니다. 광고 수익이 붙은 유튜브나 쇼핑몰 영상에 넣을 목소리라면 처음부터 유료 플랜 조건을 보고 고르는 편이 안전합니다. 왜 이 두 서비스를 같이 비교하나 쇼츠 내레이션, 수업 자료 더빙, 상품 소개 영상처럼 "내 목소리 대신 AI 목소리"가 필요할 때 한국 사용자들이 가장 많이 찾는 곳이 네오사피엔스의 타입캐스트 와 네이버의 클로바더빙 입니다. 기능 소개만 보면 비슷해 보이지만, 실제로 문제가 되는 건 음질보다 "이 목소리를 내 채널에 써도 되나" 입니다. 그래서 이 글은 기능 나열보다 무료 사용 범위, 출처 표기 의무, 유료 플랜 가격과 다운로드 한도를 중심으로 정리했습니다. 모든 수치는 2026년 10월 25일에 두 서비스의 공식 요금 페이지와 고객센터 도움말에서 직접 다시 확인한 내용입니다. 한눈에 보는 비교표 항목 타입캐스트 무료 타입캐스트 베이직 클로바더빙 Free 클로바더빙 Standard 월 요금 0원 9,900원 (연간 결제 시 10% 할인) 0원 19,900원 (네이버 클라우드 플랫폼에서 결제) 무료·포함 사용량 음성 생성·재생 무제한, 다운로드는 최초 3,000크레딧(약 5분) 1회 지급 월 30,000크레딧(약 60분) 월 15,000자, 다운로드 월 20회, 프로젝트 누적 5개 (매월 1일 갱신) 월 30,000자, 다운로드 월 40회, 프로젝트 누적 20개 쓸 수 있...