hkuds--cli-anything
wehub-resource-sync
117 行
4.6 KiB
Markdown
117 行
4.6 KiB
Markdown
# CLI-Anything for Reasonix
|
|
|
|
An adapter that brings the [CLI-Anything](https://github.com/HKUDS/CLI-Anything) harness methodology to the [Reasonix](https://github.com/esengine/DeepSeek-Reasonix) coding agent.
|
|
|
|
CLI-Anything is a methodology for making **any GUI software agent-native** by generating stateful CLI harnesses with REPL mode, JSON output, undo/redo, and comprehensive tests. This adapter lets Reasonix act as the builder agent.
|
|
|
|
## Installation
|
|
|
|
**macOS / Linux:**
|
|
|
|
```bash
|
|
git clone https://github.com/HKUDS/CLI-Anything.git
|
|
cd CLI-Anything/reasonix-skill
|
|
./scripts/install.sh
|
|
```
|
|
|
|
**Windows (PowerShell):**
|
|
|
|
```powershell
|
|
git clone https://github.com/HKUDS/CLI-Anything.git
|
|
cd CLI-Anything\reasonix-skill
|
|
.\scripts\install.ps1
|
|
```
|
|
|
|
Both scripts copy the skill to Reasonix's global skill directory at `~/.reasonix/skills/cli-anything`.
|
|
|
|
## Configuration Note
|
|
|
|
A full CLI-Anything build (architecture analysis, 10+ file generation, installation, and multiple test runs) typically requires 25–40 tool-call rounds. Reasonix's subagent step budget is derived from the `agent.max_steps` setting in `reasonix.toml`:
|
|
|
|
- The default `max_steps = 0` means unlimited, which is recommended for this workflow.
|
|
- If you have set `max_steps` to a finite value, the subagent receives half that budget (minimum 5), which may cause a build to be truncated before completion.
|
|
|
|
To ensure builds complete successfully, set `agent.max_steps = 0` in your `reasonix.toml`, or use a sufficiently high value such as 64 or more.
|
|
|
|
## Usage
|
|
|
|
After installation, use slash invocation to inline the skill into the parent Reasonix loop:
|
|
|
|
```
|
|
/cli-anything https://github.com/GNOME/gimp
|
|
```
|
|
|
|
Use `run_skill` when you want isolated subagent execution. The same isolation applies when Reasonix invokes the skill through its dedicated subagent path:
|
|
|
|
```
|
|
run_skill({ name: "cli-anything", arguments: "/path/to/software" })
|
|
```
|
|
|
|
### What It Does
|
|
|
|
The skill follows the CLI-Anything 7-phase methodology:
|
|
|
|
1. **Codebase Analysis** — Surveys the target software's architecture, data model, and API surface
|
|
2. **CLI Architecture Design** — Designs command groups, state model, and output formats
|
|
3. **Implementation** — Generates a Click-based Python CLI with REPL, JSON output, and session state
|
|
4. **Test Planning** — Creates TEST.md with comprehensive test plan
|
|
5. **Test Implementation** — Writes unit tests and E2E tests with real backend invocation
|
|
6. **Test Documentation** — Runs all tests and documents results
|
|
7. **PyPI Packaging** — Creates setup.py and verifies `pip install -e .`
|
|
|
|
### Example
|
|
|
|
```bash
|
|
# Build a CLI for GIMP from local source
|
|
/cli-anything /home/user/gimp
|
|
|
|
# Build from a GitHub repo
|
|
/cli-anything https://github.com/blender/blender
|
|
|
|
# Refine an existing harness
|
|
/cli-anything /home/user/gimp "Refine the existing harness for batch processing and Script-Fu filters"
|
|
```
|
|
|
|
## Reasonix Tool Mapping
|
|
|
|
| CLI-Anything Need | Reasonix Tool |
|
|
|-------------------|---------------|
|
|
| Shell execution | `bash` |
|
|
| File generation | `write_file` |
|
|
| Code editing | `edit_file` / `multi_edit` |
|
|
| Source reading | `read_file` |
|
|
| Codebase search | `grep` / `glob` / `ls` |
|
|
| Architecture analysis | `mcp__codegraph__search` / `mcp__codegraph__context` when CodeGraph is enabled |
|
|
| Documentation fetch | `web_fetch` |
|
|
|
|
## File Structure
|
|
|
|
```
|
|
reasonix-skill/
|
|
├── SKILL.md # Main skill document (methodology + tool bindings)
|
|
├── README.md # This file
|
|
├── agents/
|
|
│ └── reasonix.yaml # Agent interface metadata
|
|
└── scripts/
|
|
├── install.sh # macOS/Linux installer
|
|
└── install.ps1 # Windows installer
|
|
```
|
|
|
|
## How It Compares to Other Agent Adapters
|
|
|
|
| Feature | Claude Code | Codex | Hermes | **Reasonix** |
|
|
|---------|------------|-------|--------|-------------|
|
|
| Skill format | `.claude-plugin/` | `SKILL.md` + YAML | `SKILL.md` + YAML | `SKILL.md` + YAML |
|
|
| Shell | `bash` | `terminal` | `terminal` | `bash` |
|
|
| File ops | native | `execute_code` | `execute_code` / `write_file` | `write_file` / `edit_file` / `multi_edit` |
|
|
| Code analysis | file reads | file reads | file reads | Optional `mcp__codegraph__search` / `mcp__codegraph__context` symbol graph |
|
|
| Install method | `/plugin install` | `install.sh` → `$CODEX_HOME/skills/` | `install.sh` → `$HERMES_HOME/skills/` | `install.sh` → `~/.reasonix/skills/` |
|
|
|
|
## Contributing
|
|
|
|
This adapter follows the same contribution pattern as the Codex and Hermes adapters. See [CONTRIBUTING.md](../CONTRIBUTING.md) in the CLI-Anything repository.
|
|
|
|
## License
|
|
|
|
Apache License 2.0 — same as CLI-Anything.
|