Skip to content

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

Python

include CLI demos

yuhao1e9487d5a5b8
diff --git a/.gitignore b/.gitignore
index d4bdbcde3..6eb435674 100644
--- a/.gitignore
+++ b/.gitignore
@@ -23,6 +23,25 @@
!/.github/scripts/
!/.github/PULL_REQUEST_TEMPLATE.md
+# Allow examples directory
+!/examples/
+# Ignore everything inside examples first
+/examples/*
+# Then allow only the subdirs and files we need
+!/examples/README.md
+!/examples/drawio/
+!/examples/slay_the_spire_ii/
+!/examples/videocaptioner/
+# Inside each subdir, ignore everything then allow specific files
+/examples/drawio/*
+!/examples/drawio/drawio_demo.gif
+!/examples/drawio/https_handshake.png
+/examples/slay_the_spire_ii/*
+!/examples/slay_the_spire_ii/example_preview.gif
+/examples/videocaptioner/*
+!/examples/videocaptioner/videocaptioner_before.png
+!/examples/videocaptioner/videocaptioner_after.png
+
# Step 3: Allow cli-anything-plugin, codex-skill, and skill_generation tests
!/cli-anything-plugin/
!/codex-skill/
@@ -158,12 +177,10 @@
**/build/
**/.pytest_cache/
**/*.egg
-**/*.mp4
**/*.wav
**/*.blend
**/*.xcf
**/*.mlt
-**/*.drawio
# Step 8: But allow assets images
!/assets/*.png
diff --git a/README.md b/README.md
index 6bc7e6a5e..19afa9868 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,8 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software</stron
**🌐 [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**: Explore all community-built CLIs and install with one command at the **[CLI-Hub](https://hkuds.github.io/CLI-Anything/)**. Want to add your own? [Open a PR](https://github.com/HKUDS/CLI-Anything/blob/main/CONTRIBUTING.md) β€” the hub updates instantly.
+**🎬 [See Demos](#-real-world-demos)**: Watch AI agents use generated CLIs to produce real artifacts β€” diagrams, gameplay, subtitles, and more.
+
<p align="center">
<a href="#-quick-start"><img src="https://img.shields.io/badge/Quick_Start-5_min-blue?style=for-the-badge" alt="Quick Start"></a>
<a href="https://hkuds.github.io/CLI-Anything/"><img src="https://img.shields.io/badge/CLI_Hub-Browse_%26_Install-ff69b4?style=for-the-badge" alt="CLI Hub"></a>
@@ -589,6 +591,64 @@ SKILL.md files are auto-generated during Phase 6.5 of the pipeline using `skill_
---
+## 🎬 Real-World Demos
+
+AI agents using generated CLIs to produce complete, useful artifacts β€” no GUI needed.
+
+### Draw.io &mdash; HTTPS Handshake Diagram
+
+> **Harness:** `cli-anything-drawio` | **Time:** ~4 min | **Artifact:** `.drawio` + `.png`
+
+An agent creates a full HTTPS connection lifecycle diagram from scratch β€” TCP three-way handshake, TLS negotiation, encrypted data exchange, and TCP four-way termination β€” entirely through CLI commands.
+
+<p align="center">
+ <img src="examples/drawio/drawio_demo.gif" alt="Draw.io CLI demo: building an HTTPS handshake diagram" width="720" />
+</p>
+
+<details>
+<summary>Final artifact</summary>
+<p align="center">
+ <img src="examples/drawio/https_handshake.png" alt="HTTPS handshake sequence diagram" width="600" />
+</p>
+</details>
+
+*Contributed by [@zhangxilong-43](https://github.com/zhangxilong-43)*
+
+### Slay the Spire II &mdash; Game Automation
+
+> **Harness:** `cli-anything-slay-the-spire-ii` | **Artifact:** Automated gameplay session
+
+An agent plays through a Slay the Spire II run using the CLI harness β€” reading game state, selecting cards, choosing paths, and making strategic decisions in real-time.
+
+<p align="center">
+ <img src="examples/slay_the_spire_ii/example_preview.gif" alt="Slay the Spire II CLI gameplay demo" width="720" />
+</p>
+
+*Contributed by [@TianyuFan0504](https://github.com/TianyuFan0504)*
+
+### VideoCaptioner &mdash; Auto-Generated Subtitles
+
+> **Harness:** `cli-anything-videocaptioner` | **Artifact:** Captioned video frames
+
+An agent uses the VideoCaptioner CLI to automatically generate and overlay styled subtitles onto video content, with bilingual text rendering and customizable formatting.
+
+<table align="center">
+<tr>
+<td align="center"><strong>Before</strong></td>
+<td align="center"><strong>After</strong></td>
+</tr>
+<tr>
+<td><img src="examples/videocaptioner/videocaptioner_before.png" alt="Video frame before captioning" width="380" /></td>
+<td><img src="examples/videocaptioner/videocaptioner_after.png" alt="Video frame after captioning" width="380" /></td>
+</tr>
+</table>
+
+*Contributed by [@WEIFENG2333](https://github.com/WEIFENG2333)*
+
+*More CLI demos coming soon.*
+
+---
+
## 🎬 Demonstrations
### 🎯 General-Purpose
diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 000000000..a613ba5ff
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,79 @@
+# CLI-Anything Examples
+
+Real-world demonstrations of CLI-Anything harnesses in action. Each example shows an AI agent (Claude Code) using a generated CLI to produce a complete, useful artifact β€” no GUI needed.
+
+---
+
+## Draw.io &mdash; HTTPS Handshake Diagram
+
+> **Harness:** `cli-anything-drawio` | **Time:** ~4 min | **Artifact:** `.drawio` + `.png`
+
+An agent creates a full HTTPS connection lifecycle diagram from scratch β€” TCP three-way handshake, TLS negotiation, encrypted data exchange, and TCP four-way termination β€” entirely through CLI commands.
+
+<p align="center">
+ <img src="drawio/drawio_demo.gif" alt="Draw.io CLI demo: building an HTTPS handshake diagram" width="720" />
+</p>
+
+<details>
+<summary>Final artifact</summary>
+<p align="center">
+ <img src="drawio/https_handshake.png" alt="HTTPS handshake sequence diagram" width="600" />
+</p>
+</details>
+
+**What it demonstrates:**
+- Creating shapes (rectangles, labels) with precise positioning
+- Adding styled connectors (arrows with colors, labels, dashed lines)
+- Section-based layout with color-coded phases (orange/purple/teal/red)
+- Exporting to PNG via the Draw.io backend
+
+*Contributed by [@zhangxilong-43](https://github.com/zhangxilong-43)*
+
+---
+
+## Slay the Spire II &mdash; Game Automation
+
+> **Harness:** `cli-anything-slay-the-spire-ii` | **Artifact:** Automated gameplay session
+
+An agent plays through a Slay the Spire II run using the CLI harness β€” reading game state, selecting cards, choosing paths, and making strategic decisions in real-time.
+
+<p align="center">
+ <img src="slay_the_spire_ii/example_preview.gif" alt="Slay the Spire II CLI gameplay demo" width="720" />
+</p>
+
+**What it demonstrates:**
+- Real-time game state reading and decision making
+- Complex multi-step strategy execution
+- Agent-driven interaction with a live application
+
+*Contributed by [@TianyuFan0504](https://github.com/TianyuFan0504)*
+
+---
+
+## VideoCaptioner &mdash; Auto-Generated Subtitles
+
+> **Harness:** `cli-anything-videocaptioner` | **Artifact:** Captioned video frames
+
+An agent uses the VideoCaptioner CLI to automatically generate and overlay styled subtitles onto video content, with bilingual text rendering and customizable formatting.
+
+<table align="center">
+<tr>
+<td align="center"><strong>Before</strong></td>
+<td align="center"><strong>After</strong></td>
+</tr>
+<tr>
+<td><img src="videocaptioner/videocaptioner_before.png" alt="Video frame before captioning" width="380" /></td>
+<td><img src="videocaptioner/videocaptioner_after.png" alt="Video frame after captioning" width="380" /></td>
+</tr>
+</table>
+
+**What it demonstrates:**
+- Automatic speech-to-text subtitle generation
+- Bilingual caption overlay (Chinese + English)
+- Styled text rendering with custom formatting and positioning
+
+*Contributed by [@WEIFENG2333](https://github.com/WEIFENG2333)*
+
+---
+
+## More CLI Demos Coming Soon
diff --git a/examples/drawio/drawio_demo.gif b/examples/drawio/drawio_demo.gif
new file mode 100644
index 000000000..6a07b989e
Binary files /dev/null and b/examples/drawio/drawio_demo.gif differ
diff --git a/examples/drawio/https_handshake.png b/examples/drawio/https_handshake.png
new file mode 100644
index 000000000..83a7eb1c0
Binary files /dev/null and b/examples/drawio/https_handshake.png differ
diff --git a/examples/slay_the_spire_ii/example_preview.gif b/examples/slay_the_spire_ii/example_preview.gif
new file mode 100644
index 000000000..dd87679dd
Binary files /dev/null and b/examples/slay_the_spire_ii/example_preview.gif differ
diff --git a/examples/videocaptioner/videocaptioner_after.png b/examples/videocaptioner/videocaptioner_after.png
new file mode 100644
index 000000000..fe30d9c18
Binary files /dev/null and b/examples/videocaptioner/videocaptioner_after.png differ
diff --git a/examples/videocaptioner/videocaptioner_before.png b/examples/videocaptioner/videocaptioner_before.png
new file mode 100644
index 000000000..f43628847
Binary files /dev/null and b/examples/videocaptioner/videocaptioner_before.png differ