wehub-resource-sync
122 lines
3.7 KiB
Markdown
122 lines
3.7 KiB
Markdown
# cli-hub
|
|
|
|
Package manager for [CLI-Anything](https://github.com/HKUDS/CLI-Anything) — a framework that auto-generates stateful CLI interfaces for GUI applications, making them agent-native.
|
|
|
|
Browse, install, and manage 40+ CLI harnesses for software like GIMP, Blender, Inkscape, LibreOffice, Audacity, OBS Studio, and more — all from your terminal.
|
|
|
|
**Web Hub**: [clianything.cc](https://clianything.cc)
|
|
|
|
## Install
|
|
|
|
```bash
|
|
pip install cli-anything-hub
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
# Browse all available CLIs, grouped by category
|
|
cli-hub list
|
|
|
|
# Filter by category (image, 3d, video, audio, office, ai, ...)
|
|
cli-hub list -c image
|
|
|
|
# Search by name, description, or category
|
|
cli-hub search "3d modeling"
|
|
|
|
# Show details for a CLI
|
|
cli-hub info gimp
|
|
|
|
# Install a CLI harness
|
|
cli-hub install gimp
|
|
|
|
# Update a CLI to the latest version
|
|
cli-hub update gimp
|
|
|
|
# Uninstall a CLI
|
|
cli-hub uninstall gimp
|
|
```
|
|
|
|
## Preview Viewer
|
|
|
|
`cli-hub` also includes the generic preview consumer for preview-capable
|
|
harnesses.
|
|
|
|
Use this split:
|
|
|
|
- `cli-anything-<software> preview ...` creates or updates preview state
|
|
- `cli-hub previews ...` inspects or opens that existing preview state
|
|
|
|
Canonical viewer commands:
|
|
|
|
```bash
|
|
# Inspect an existing preview bundle or live session
|
|
cli-hub previews inspect /path/to/bundle-or-session
|
|
|
|
# Render HTML for a bundle or live session
|
|
cli-hub previews html /path/to/bundle-or-session -o page.html
|
|
|
|
# Watch a live session over localhost
|
|
cli-hub previews watch /path/to/session --open --poll-ms 1500
|
|
|
|
# Open a bundle or live session directly in a browser
|
|
cli-hub previews open /path/to/bundle-or-session
|
|
```
|
|
|
|
For live sessions, `cli-hub previews` reads:
|
|
|
|
- `session.json` for the current head
|
|
- `trajectory.json` for the command-to-preview history
|
|
- the current bundle manifest and artifacts
|
|
|
|
This command group never renders or publishes previews by itself.
|
|
|
|
## What gets installed
|
|
|
|
Each CLI harness is a standalone Python package that wraps a real application (GIMP, Blender, etc.) with a stateful command-line interface. Every harness supports:
|
|
|
|
- **REPL mode**: `cli-anything-gimp` launches an interactive session
|
|
- **One-shot commands**: `cli-anything-gimp project create --name my-project`
|
|
- **JSON output**: `cli-anything-gimp --json project list` for machine-readable output
|
|
- **Undo/redo**: Stateful project management with full operation history
|
|
|
|
## For AI agents
|
|
|
|
cli-hub is designed to be agent-friendly. AI coding agents can:
|
|
|
|
1. `pip install cli-anything-hub` to get the package manager
|
|
2. `cli-hub search <keyword>` or `cli-hub list --json` to discover tools
|
|
3. `cli-hub install <name>` to install what they need
|
|
4. Use `--json` output for structured data parsing
|
|
5. For preview-capable harnesses, call `cli-anything-<software> preview ... --json`
|
|
first, then inspect returned bundle/session paths with `cli-hub previews ...`
|
|
|
|
## Available categories
|
|
|
|
3D, AI, Audio, Communication, Database, Design, DevOps, Diagrams, Game, GameDev, Generation, Graphics, Image, Music, Network, Office, OSINT, Project Management, Search, Streaming, Testing, Video, Web
|
|
|
|
## JSON output
|
|
|
|
All listing commands support `--json` for machine-readable output:
|
|
|
|
```bash
|
|
cli-hub list --json
|
|
cli-hub search blender --json
|
|
```
|
|
|
|
## Analytics
|
|
|
|
cli-hub sends anonymous usage events to help track adoption. The default provider is [PostHog](https://posthog.com), while the legacy Umami path remains available via `CLI_HUB_ANALYTICS_PROVIDER=umami`. No personal data is collected.
|
|
|
|
Opt out:
|
|
|
|
```bash
|
|
export CLI_HUB_NO_ANALYTICS=1
|
|
```
|
|
|
|
## Links
|
|
|
|
- **Web Hub**: [clianything.cc](https://clianything.cc)
|
|
- **Repository**: [github.com/HKUDS/CLI-Anything](https://github.com/HKUDS/CLI-Anything)
|
|
- **Live Catalog**: [SKILL.md](https://reeceyang.sgp1.cdn.digitaloceanspaces.com/SKILL.md)
|