Skip to content

docs: clarify the Claude Code 2.x /cli-anything command #50

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tsubasakong wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: clarify the Claude Code 2.x /cli-anything command #50

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
457f02d
docs: clarify Claude Code 2.x cli-anything command
tsubasakong Mar 12, 2026
c141671
Merge remote-tracking branch 'upstream/main' into docs/19-claude-code…
tsubasakong Mar 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions cli-anything-plugin/QUICKSTART.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ cp -r /root/cli-anything/cli-anything-plugin ~/.claude/plugins/cli-anything
/reload-plugins

# Verify installation
/help cli-anything
/help cli-anything:cli-anything
```

## Your First CLI Harness
Expand All @@ -21,7 +21,7 @@ Let's build a CLI for a simple GUI application:

```bash
# Build complete CLI harness for GIMP
/cli-anything gimp
/cli-anything:cli-anything /path/to/gimp
```

This will:
Expand Down Expand Up @@ -96,13 +96,13 @@ CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything/gimp/tests/ -v -s

```bash
# Build CLI for Blender (3D software)
/cli-anything blender
/cli-anything:cli-anything /home/user/blender

# Build CLI for Inkscape (vector graphics)
/cli-anything inkscape
/cli-anything:cli-anything /home/user/inkscape

# Build CLI for Audacity (audio editor)
/cli-anything audacity
/cli-anything:cli-anything /home/user/audacity
```

## Refining an Existing CLI
Expand All @@ -121,13 +121,13 @@ After the initial build, use the refine command to expand coverage:

### Build and Test
```bash
/cli-anything /home/user/gimp
/cli-anything:cli-anything /home/user/gimp
/cli-anything:test /home/user/gimp
```

### Build, Validate, Test, Install
```bash
/cli-anything /home/user/blender
/cli-anything:cli-anything /home/user/blender
/cli-anything:validate /home/user/blender
/cli-anything:test /home/user/blender
cd /root/cli-anything/blender/agent-harness
Expand Down Expand Up @@ -212,7 +212,7 @@ cli-anything-blender --help
1. **Read the full README:** `cat README.md`
2. **Study an example:** Explore `/root/cli-anything/gimp/agent-harness/cli_anything/gimp/`
3. **Read HARNESS.md:** Understand the methodology at `~/.claude/plugins/cli-anything/HARNESS.md`
4. **Build your own:** Choose a GUI app and run `/cli-anything <app-name>`
4. **Build your own:** Choose a GUI app and run `/cli-anything:cli-anything <software-path-or-repo>`

## Tips

Expand Down
10 changes: 5 additions & 5 deletions cli-anything-plugin/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,17 +53,17 @@ pip install click pytest

## Commands

### `/cli-anything <software-path-or-repo>`
### `/cli-anything:cli-anything <software-path-or-repo>`

Build a complete CLI harness for any software application. Accepts a local path to the software source code or a GitHub repository URL.

**Examples:**
```bash
# Build from local source
/cli-anything /home/user/gimp
/cli-anything:cli-anything /home/user/gimp

# Build from a GitHub repo
/cli-anything https://github.com/blender/blender
/cli-anything:cli-anything https://github.com/blender/blender
```

This runs all 7 phases:
Expand Down Expand Up @@ -374,7 +374,7 @@ This makes CLIs discoverable by AI agents that can check `which cli-anything-<so

- Verify output directory: `ls -la /root/cli-anything/<software>/agent-harness/cli_anything/<software>/`
- Check for errors in build phase
- Try rebuilding: `/cli-anything <software-path>`
- Try rebuilding: `/cli-anything:cli-anything <software-path>`

### Import errors

Expand All @@ -394,7 +394,7 @@ This makes CLIs discoverable by AI agents that can check `which cli-anything-<so
To add support for new software:

1. Clone the target application's repository
2. Run `/cli-anything <software-name>`
2. Run `/cli-anything:cli-anything <software-path-or-repo>`
3. Review and refine the generated CLI
4. Submit a PR with the new harness

Expand Down
8 changes: 5 additions & 3 deletions cli-anything-plugin/commands/cli-anything.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,11 @@ Build a complete, stateful CLI harness for any GUI application.
## Usage

```bash
/cli-anything <software-path-or-repo>
/cli-anything:cli-anything <software-path-or-repo>
```

> Claude Code 2.x uses the namespaced command form above. On older releases, the legacy `/cli-anything` alias may still work.

## Arguments

- `<software-path-or-repo>` - **Required.** Either:
Expand Down Expand Up @@ -104,10 +106,10 @@ This command implements the complete cli-anything methodology to build a product

```bash
# Build a CLI for GIMP from local source
/cli-anything /home/user/gimp
/cli-anything:cli-anything /home/user/gimp

# Build from a GitHub repo
/cli-anything https://github.com/blender/blender
/cli-anything:cli-anything https://github.com/blender/blender
```

## Success Criteria
Expand Down