diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 564a10ff0..d10f0d301 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -22,7 +22,8 @@ Fixes # - [ ] `.md` SOP document exists at `/agent-harness/.md` -- [ ] `SKILL.md` exists inside the Python package (`cli_anything//SKILL.md`) +- [ ] Canonical `SKILL.md` exists at `skills/cli-anything-/SKILL.md` +- [ ] Packaged compatibility `SKILL.md` exists at `cli_anything//skills/SKILL.md` - [ ] Unit tests at `cli_anything//tests/test_core.py` are present and pass without backend - [ ] E2E tests at `cli_anything//tests/test_full_e2e.py` are present - [ ] `README.md` includes the new software (with link to harness directory) diff --git a/.github/scripts/sync_root_skills.py b/.github/scripts/sync_root_skills.py new file mode 100644 index 000000000..7da0ea8b2 --- /dev/null +++ b/.github/scripts/sync_root_skills.py @@ -0,0 +1,79 @@ +#!/usr/bin/env python3 +"""Sync repo-root skills/ from harness-local SKILL.md files.""" + +from __future__ import annotations + +from pathlib import Path + + +REPO_ROOT = Path(__file__).resolve().parents[2] +ROOT_SKILLS_DIR = REPO_ROOT / "skills" + + +def _canonical_skill_id(source: Path) -> str: + rel = source.relative_to(REPO_ROOT) + parts = rel.parts + if "cli_anything" in parts: + package_index = parts.index("cli_anything") + 1 + if package_index < len(parts): + package_name = parts[package_index] + return f"cli-anything-{package_name.replace('_', '-')}" + + software_dir = parts[0] + return f"cli-anything-{software_dir.replace('_', '-')}" + + +def _rewrite_name_frontmatter(content: str, skill_id: str) -> str: + if not content.startswith("---\n"): + return content + + parts = content.split("---\n", 2) + if len(parts) < 3: + return content + + _, frontmatter, body = parts + lines = frontmatter.splitlines(keepends=True) + rewritten: list[str] = [] + replaced = False + i = 0 + while i < len(lines): + line = lines[i] + if not replaced and line.startswith("name:"): + rewritten.append(f'name: "{skill_id}"\n') + replaced = True + i += 1 + while i < len(lines) and (lines[i].startswith(" ") or lines[i].startswith("\t")): + i += 1 + continue + rewritten.append(line) + i += 1 + + if not replaced: + rewritten.insert(0, f'name: "{skill_id}"\n') + + frontmatter = "".join(rewritten) + return f"---\n{frontmatter}---\n{body}" + + +def _discover_sources() -> list[Path]: + sources: list[Path] = [] + sources.extend(sorted(REPO_ROOT.glob("*/agent-harness/cli_anything/*/skills/SKILL.md"))) + sources.extend(sorted(REPO_ROOT.glob("*/agent-harness/cli_anything/*/SKILL.md"))) + return [path for path in sources if path.is_file()] + + +def main() -> int: + sources = _discover_sources() + ROOT_SKILLS_DIR.mkdir(parents=True, exist_ok=True) + + for source in sources: + skill_id = _canonical_skill_id(source) + target = ROOT_SKILLS_DIR / skill_id / "SKILL.md" + target.parent.mkdir(parents=True, exist_ok=True) + content = source.read_text(encoding="utf-8") + target.write_text(_rewrite_name_frontmatter(content, skill_id), encoding="utf-8") + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/.github/scripts/tests/test_update_registry_dates.py b/.github/scripts/tests/test_update_registry_dates.py new file mode 100644 index 000000000..894ee5627 --- /dev/null +++ b/.github/scripts/tests/test_update_registry_dates.py @@ -0,0 +1,56 @@ +from __future__ import annotations + +import importlib.util +from pathlib import Path + + +SCRIPT_PATH = Path(__file__).resolve().parents[1] / "update_registry_dates.py" +SPEC = importlib.util.spec_from_file_location("update_registry_dates", SCRIPT_PATH) +MODULE = importlib.util.module_from_spec(SPEC) +assert SPEC and SPEC.loader +SPEC.loader.exec_module(MODULE) + + +def test_resolve_harness_path_prefers_install_subdirectory_for_qgis(): + cli = { + "name": "qgis", + "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=QGIS/agent-harness", + "skill_md": "QGIS/agent-harness/cli_anything/qgis/skills/SKILL.md", + } + + path = MODULE.resolve_harness_path(cli, MODULE.REPO_ROOT) + + assert path == MODULE.REPO_ROOT / "QGIS" / "agent-harness" + + +def test_resolve_harness_path_handles_underscore_directory_names(): + cli = { + "name": "unimol_tools", + "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=unimol_tools/agent-harness", + "skill_md": "skills/cli-anything-unimol-tools/SKILL.md", + } + + path = MODULE.resolve_harness_path(cli, MODULE.REPO_ROOT) + + assert path == MODULE.REPO_ROOT / "unimol_tools" / "agent-harness" + + +def test_extract_external_source_url_from_cargo_git_install(): + cli = { + "name": "clibrowser", + "install_cmd": "cargo install --git https://github.com/allthingssecurity/clibrowser.git --tag v0.1.0 --locked", + "source_url": None, + } + + source_url = MODULE.extract_external_source_url(cli) + + assert source_url == "https://github.com/allthingssecurity/clibrowser" + + +def test_extract_npm_package_supports_scoped_package_names(): + cli = { + "npm_package": "@sentry/cli", + "install_cmd": "npm install -g @sentry/cli", + } + + assert MODULE._extract_npm_package(cli) == "@sentry/cli" diff --git a/.github/scripts/update_registry_dates.py b/.github/scripts/update_registry_dates.py index 228afce39..af1bfcb32 100644 --- a/.github/scripts/update_registry_dates.py +++ b/.github/scripts/update_registry_dates.py @@ -1,105 +1,278 @@ #!/usr/bin/env python3 -"""Update registry-dates.json with last modified dates from harness directories.""" +"""Update registry-dates.json with meaningful per-CLI update dates.""" + +from __future__ import annotations + import json import re +import shlex import subprocess +import urllib.parse import urllib.request +from datetime import datetime, timezone +from email.utils import parsedate_to_datetime from pathlib import Path -from datetime import datetime -def get_last_modified(harness_path): - """Get the most recent git commit date for files in a harness directory.""" +REPO_ROOT = Path(__file__).resolve().parents[2] +USER_AGENT = "CLI-Anything registry date updater" +GITHUB_REPO_RE = re.compile(r"https://github\.com/([^/]+/[^/#?]+?)(?:\.git)?(?:[/?#].*)?$") +GIT_URL_RE = re.compile(r"https://github\.com/[^\s#]+") +SUBDIRECTORY_RE = re.compile(r"#subdirectory=([^\s]+)") + + +def _fetch_json(url: str) -> dict | None: try: + req = urllib.request.Request( + url, + headers={ + "Accept": "application/json", + "User-Agent": USER_AGENT, + }, + ) + with urllib.request.urlopen(req, timeout=10) as resp: + return json.loads(resp.read()) + except Exception: + return None + + +def _fetch_last_modified(url: str) -> str | None: + try: + req = urllib.request.Request(url, headers={"User-Agent": USER_AGENT}, method="HEAD") + with urllib.request.urlopen(req, timeout=10) as resp: + last_modified = resp.headers.get("Last-Modified") + if not last_modified: + return None + return parsedate_to_datetime(last_modified).astimezone(timezone.utc).strftime("%Y-%m-%d") + except Exception: + return None + + +def _git_log_timestamp(target_path: Path, excluded_globs: tuple[str, ...] = ()) -> int | None: + try: + relative_target = target_path.relative_to(REPO_ROOT).as_posix() + cmd = ["git", "log", "-1", "--format=%ct", "--", relative_target] + cmd.extend(f":(exclude,glob){pattern}" for pattern in excluded_globs) result = subprocess.run( - ['git', 'log', '-1', '--format=%ct', '--', str(harness_path)], + cmd, capture_output=True, text=True, - check=True + check=True, + cwd=REPO_ROOT, ) - timestamp = int(result.stdout.strip()) - return datetime.fromtimestamp(timestamp).strftime('%Y-%m-%d') + return int(result.stdout.strip()) except (subprocess.CalledProcessError, ValueError): return None -def get_github_repo_date(source_url): +def get_last_modified(target_path: Path) -> str | None: + """Get the most recent git commit date for CLI-specific files in a repo path.""" + relative_target = target_path.relative_to(REPO_ROOT).as_posix() + shared_file_globs = ( + f"{relative_target}/cli_anything/**/utils/repl_skin.py", + f"{relative_target}/cli_anything/**/skills/SKILL.md", + f"{relative_target}/cli_anything/**/SKILL.md", + ) + + timestamp = _git_log_timestamp(target_path, excluded_globs=shared_file_globs) + if timestamp is None: + timestamp = _git_log_timestamp(target_path) + if timestamp is None: + return None + + try: + return datetime.fromtimestamp(timestamp, tz=timezone.utc).strftime("%Y-%m-%d") + except (OverflowError, OSError, ValueError): + return None + + +def get_github_repo_date(source_url: str) -> str | None: """Get the last push date from a GitHub repo via the API.""" - # Extract owner/repo from URL like https://github.com/owner/repo - match = re.match(r'https://github\.com/([^/]+/[^/]+?)(?:\.git)?$', source_url) + match = GITHUB_REPO_RE.match(source_url) if not match: return None repo_slug = match.group(1) - api_url = f'https://api.github.com/repos/{repo_slug}' - try: - req = urllib.request.Request(api_url, headers={'Accept': 'application/vnd.github.v3+json'}) - with urllib.request.urlopen(req, timeout=10) as resp: - data = json.loads(resp.read()) - pushed_at = data.get('pushed_at') # e.g. "2026-04-13T08:00:00Z" - if pushed_at: - return pushed_at[:10] - except Exception: - pass - return None + data = _fetch_json(f"https://api.github.com/repos/{repo_slug}") + if not data: + return None + pushed_at = data.get("pushed_at") + return pushed_at[:10] if pushed_at else None -def get_pypi_date(install_cmd): - """Get the last release date from PyPI for a simple pip package.""" - # Only works for plain "pip install " commands (not git+ URLs) - match = re.match(r'^pip install ([a-zA-Z0-9_-]+)$', install_cmd) - if not match: +def _extract_pypi_package(install_cmd: str) -> str | None: + if not install_cmd: return None - package = match.group(1) - api_url = f'https://pypi.org/pypi/{package}/json' try: - with urllib.request.urlopen(api_url, timeout=10) as resp: - data = json.loads(resp.read()) - # Get the upload time of the latest version - latest = data.get('info', {}).get('version') - releases = data.get('releases', {}) - if latest and releases.get(latest): - upload_time = releases[latest][0].get('upload_time') # e.g. "2026-04-10T12:00:00" - if upload_time: - return upload_time[:10] - except Exception: - pass + tokens = shlex.split(install_cmd) + except ValueError: + return None + + if not tokens: + return None + + install_index = None + if tokens[:3] == ["python3", "-m", "pip"]: + install_index = 3 + elif tokens[0] in {"pip", "pip3"}: + install_index = 1 + + if install_index is None or install_index >= len(tokens) or tokens[install_index] != "install": + return None + + for token in tokens[install_index + 1 :]: + if token.startswith("-"): + continue + if "://" in token or token.startswith("git+"): + return None + return token return None -def get_external_date(cli): - """Get the last update date for an external CLI, trying GitHub API then PyPI.""" - source_url = cli.get('source_url') +def get_pypi_date(install_cmd: str) -> str | None: + """Get the last release date from PyPI for a pip-installable package.""" + package = _extract_pypi_package(install_cmd) + if not package: + return None + data = _fetch_json(f"https://pypi.org/pypi/{package}/json") + if not data: + return None + latest = data.get("info", {}).get("version") + releases = data.get("releases", {}) + release_files = releases.get(latest or "", []) + if not release_files: + return None + upload_time = release_files[0].get("upload_time") or release_files[0].get("upload_time_iso_8601") + return upload_time[:10] if upload_time else None + + +def _extract_npm_package(cli: dict) -> str | None: + package = cli.get("npm_package") + if package: + return package + + install_cmd = cli.get("install_cmd", "") + match = re.search(r"npm install -g (\S+)", install_cmd) + return match.group(1) if match else None + + +def get_npm_date(cli: dict) -> str | None: + """Get the latest publish date from the npm registry.""" + package = _extract_npm_package(cli) + if not package: + return None + encoded = urllib.parse.quote(package, safe="") + data = _fetch_json(f"https://registry.npmjs.org/{encoded}") + if not data: + return None + latest = data.get("dist-tags", {}).get("latest") + published = data.get("time", {}).get(latest or "") + return published[:10] if published else None + + +def _extract_install_subdirectory(cli: dict) -> str | None: + install_cmd = cli.get("install_cmd") or "" + match = SUBDIRECTORY_RE.search(install_cmd) + return match.group(1) if match else None + + +def _extract_skill_subdirectory(cli: dict) -> str | None: + skill_md = cli.get("skill_md") + if not skill_md or skill_md.startswith("http"): + return None + marker = "/agent-harness/" + if marker not in skill_md: + return None + return skill_md.split(marker, 1)[0] + marker.rstrip("/") + + +def resolve_harness_path(cli: dict, repo_root: Path) -> Path | None: + """Resolve the on-disk harness path for an in-repo CLI entry.""" + for relative in (_extract_install_subdirectory(cli), _extract_skill_subdirectory(cli)): + if relative: + candidate = repo_root / relative + if candidate.exists(): + return candidate + + candidate_dirs = [] + for name in (cli.get("name"), cli.get("name", "").replace("-", "_"), cli.get("name", "").replace("_", "-")): + if name and name not in candidate_dirs: + candidate_dirs.append(name) + + for directory in candidate_dirs: + candidate = repo_root / directory / "agent-harness" + if candidate.exists(): + return candidate + return None + + +def extract_external_source_url(cli: dict) -> str | None: + """Best-effort source URL discovery for third-party CLIs.""" + source_url = cli.get("source_url") + if source_url: + return source_url + + install_cmd = cli.get("install_cmd") or "" + git_match = GIT_URL_RE.search(install_cmd) + if git_match: + return git_match.group(0).removesuffix(".git") + + for field in ("homepage", "docs_url"): + value = cli.get(field) + if value and "github.com/" in value: + return value + return None + + +def get_external_date(cli: dict) -> str | None: + """Get a useful update date for external/public CLIs.""" + source_url = extract_external_source_url(cli) if source_url: date = get_github_repo_date(source_url) if date: return date - # Fallback to PyPI - return get_pypi_date(cli.get('install_cmd', '')) + + package_manager = (cli.get("package_manager") or "").lower() + if package_manager == "npm": + date = get_npm_date(cli) + if date: + return date + + date = get_pypi_date(cli.get("install_cmd", "")) + if date: + return date + + for field in ("homepage", "docs_url"): + url = cli.get(field) + if url: + date = _fetch_last_modified(url) + if date: + return date + return None -def main(): - repo_root = Path(__file__).parent.parent.parent - registry_path = repo_root / 'registry.json' - dates_path = repo_root / 'docs' / 'hub' / 'registry-dates.json' +def get_cli_date(cli: dict, repo_root: Path) -> str | None: + harness_path = resolve_harness_path(cli, repo_root) + if harness_path: + return get_last_modified(harness_path) + return get_external_date(cli) - with open(registry_path) as f: - data = json.load(f) - dates = {} - for cli in data['clis']: - if cli.get('source_url'): - # External repo: query GitHub API / PyPI for real update date - dates[cli['name']] = get_external_date(cli) - else: - # In-repo: use the last commit in the harness directory - harness_path = repo_root / cli['name'] / 'agent-harness' - if harness_path.exists(): - dates[cli['name']] = get_last_modified(harness_path) +def _load_registry(path: Path) -> list[dict]: + with path.open(encoding="utf-8") as f: + return json.load(f)["clis"] - with open(dates_path, 'w') as f: + +def main() -> None: + dates_path = REPO_ROOT / "docs" / "hub" / "registry-dates.json" + all_clis = _load_registry(REPO_ROOT / "registry.json") + _load_registry(REPO_ROOT / "public_registry.json") + + dates = {cli["name"]: get_cli_date(cli, REPO_ROOT) for cli in all_clis} + + with dates_path.open("w", encoding="utf-8") as f: json.dump(dates, f, indent=2) print(f"Updated dates for {len(dates)} CLI entries") -if __name__ == '__main__': + +if __name__ == "__main__": main() diff --git a/.github/scripts/validate_root_skills.py b/.github/scripts/validate_root_skills.py new file mode 100644 index 000000000..818fd8743 --- /dev/null +++ b/.github/scripts/validate_root_skills.py @@ -0,0 +1,60 @@ +#!/usr/bin/env python3 +"""Validate that deep harness SKILL.md files are mirrored in repo-root skills/.""" + +from __future__ import annotations + +import sys +from pathlib import Path + + +REPO_ROOT = Path(__file__).resolve().parents[2] + + +def _load_sync_helpers(): + namespace: dict[str, object] = {"__file__": str(REPO_ROOT / ".github" / "scripts" / "sync_root_skills.py")} + sync_script = REPO_ROOT / ".github" / "scripts" / "sync_root_skills.py" + exec(sync_script.read_text(encoding="utf-8"), namespace) + return namespace + + +def main() -> int: + sync = _load_sync_helpers() + discover_sources = sync["_discover_sources"] + canonical_skill_id = sync["_canonical_skill_id"] + rewrite_name_frontmatter = sync["_rewrite_name_frontmatter"] + root_skills_dir = sync["ROOT_SKILLS_DIR"] + + errors: list[str] = [] + for source in discover_sources(): + skill_id = canonical_skill_id(source) + target = root_skills_dir / skill_id / "SKILL.md" + if not target.is_file(): + errors.append( + f"Missing root skill for {source.relative_to(REPO_ROOT)}: expected {target.relative_to(REPO_ROOT)}" + ) + continue + + source_content = source.read_text(encoding="utf-8") + expected = rewrite_name_frontmatter(source_content, skill_id) + actual = target.read_text(encoding="utf-8") + if actual != expected: + errors.append( + f"Out-of-sync root skill for {source.relative_to(REPO_ROOT)}: {target.relative_to(REPO_ROOT)}" + ) + + if errors: + print("Root skills validation failed:", file=sys.stderr) + for error in errors: + print(f"- {error}", file=sys.stderr) + print( + "Run `python3 .github/scripts/sync_root_skills.py` and commit the updated root skills.", + file=sys.stderr, + ) + return 1 + + print("Root skills validation passed.") + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/.github/workflows/check-root-skills.yml b/.github/workflows/check-root-skills.yml new file mode 100644 index 000000000..024017297 --- /dev/null +++ b/.github/workflows/check-root-skills.yml @@ -0,0 +1,35 @@ +name: Check Root Skills + +on: + pull_request: + paths: + - '*/agent-harness/**' + - 'skills/**' + - '.github/scripts/sync_root_skills.py' + - '.github/scripts/validate_root_skills.py' + - '.github/workflows/check-root-skills.yml' + push: + branches: + - main + paths: + - '*/agent-harness/**' + - 'skills/**' + - '.github/scripts/sync_root_skills.py' + - '.github/scripts/validate_root_skills.py' + - '.github/workflows/check-root-skills.yml' + workflow_dispatch: + +jobs: + validate-root-skills: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Setup Python + uses: actions/setup-python@v5 + with: + python-version: '3.10' + + - name: Validate root skills mirror + run: python3 .github/scripts/validate_root_skills.py diff --git a/.gitignore b/.gitignore index e39f15353..413a2eacb 100644 --- a/.gitignore +++ b/.gitignore @@ -52,6 +52,9 @@ !/openclaw-skill/ !/cli-hub-meta-skill/ !/cli-hub/ +!/cli-hub-matrix/ +!/skills/ +!/skills/** # Ignore cli-hub-skill (auto-generated, not tracked) /cli-hub-skill/ @@ -255,6 +258,7 @@ assets/gen_typing_gif.py # Step 10: Allow CLI Hub registry and frontend !/registry.json !/public_registry.json +!/matrix_registry.json !/docs/ /docs/* !/docs/hub/ diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1e3dae366..a485a8962 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -15,7 +15,7 @@ Adding a new CLI harness is the most impactful contribution. You can either add Place your code under `/agent-harness/` and ensure the following: 1. **`.md`** — the SOP document exists at `/agent-harness/.md` describing the harness architecture. -2. **`SKILL.md`** — the AI-discoverable skill definition exists inside the Python package at `cli_anything//SKILL.md`. +2. **`SKILL.md`** — the canonical AI-discoverable skill definition exists at `skills/cli-anything-/SKILL.md`, and the packaged compatibility copy exists at `cli_anything//skills/SKILL.md`. 3. **Tests** — unit tests (`test_core.py`, passable without backend) and E2E tests (`test_full_e2e.py`) are present and passing. 4. **`README.md`** — the project README includes the new software with a link to its harness directory. 5. **`registry.json`** — add an entry for the new software (see [Registry fields](#registry-fields) below). @@ -67,7 +67,7 @@ Include an entry in `registry.json` as part of your PR. Each field is described | `source_url` | Yes | For standalone repos: URL to your repo (e.g. `"https://github.com/user/repo"`). For in-repo harnesses: `null` (the hub auto-links to `/agent-harness/`). | | `install_cmd` | Yes | Full pip install command. PyPI: `"pip install cli-anything-my-software"`. In-repo: `"pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=my-software/agent-harness"`. | | `entry_point` | Yes | CLI command name (e.g. `"cli-anything-my-software"`). | -| `skill_md` | Yes | Path to SKILL.md. For standalone repos: full URL (e.g. `"https://github.com/user/repo/blob/main/.../SKILL.md"`). For in-repo: relative path (e.g. `"my-software/agent-harness/cli_anything/my_software/skills/SKILL.md"`). Set to `null` if not yet available. | +| `skill_md` | Yes | Path to canonical SKILL.md. For standalone repos: full URL (e.g. `"https://github.com/user/repo/blob/main/.../SKILL.md"`). For in-repo: relative path under the repo-root `skills/` tree (e.g. `"skills/cli-anything-my-software/SKILL.md"`). Set to `null` if not yet available. | | `category` | Yes | One of the existing categories (check `registry.json` for examples). | | `contributors` | Yes | Array of `{"name": "...", "url": "..."}` objects listing all contributors. | @@ -84,7 +84,7 @@ Include an entry in `registry.json` as part of your PR. Each field is described "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=my-software/agent-harness", "entry_point": "cli-anything-my-software", - "skill_md": "my-software/agent-harness/cli_anything/my_software/skills/SKILL.md", + "skill_md": "skills/cli-anything-my-software/SKILL.md", "category": "category-name", "contributors": [ {"name": "your-github-username", "url": "https://github.com/your-github-username"} diff --git a/README.md b/README.md index 3d19bd474..0c028cba9 100644 --- a/README.md +++ b/README.md @@ -45,6 +45,12 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software Thanks to all invaluable efforts from the community! More updates continuously on the way everyday.. +- **2026-04-18** 🧩 **All SKILL.md files are now being unified under the top-level `skills/` directory** — every CLI skill can be installed from one canonical source with `npx skills add HKUDS/CLI-Anything --skill -g -y`. We also added root-skill validation CI, synced contribution / PR docs and REPL skill-path hints to the new layout, and refreshed the **CLI-Hub** install-first frontend around the new `npx skills` flow. + +- **2026-04-17** 🌐 **CLI-Hub** received another install UX pass — public registry metadata and skill coverage were tightened, visit counting was corrected, and the web hub was further refined. 🧪 **Shotcut** render output duration was fixed (#92). 📝 **SKILL** contribution paths were corrected for the new docs flow (#224), and the skill generator now safely handles empty intros (#203). + +- **2026-04-16** 🗺️ **QGIS CLI** merged (#207) — a full GIS / map authoring harness landed. 🧬 **UniMol Tools CLI** merged (#219) for molecular modeling workflows. 🌐 **CLI-Hub** also added more public CLIs, including **py4csr**, refreshed its generated meta-skill, corrected SKILL contribution docs, and fixed `apt-get` package extraction in skill generation (#204). + - **2026-04-15** 🌐 **CLI-Hub** updated to **v0.2.0** — the PyPI package now supports public CLIs from multiple install sources (`pip`, `npm`, `brew`, bundled/system tools), backed by a new `public_registry.json`. The Hub frontend was redesigned with separate **CLI-Anything CLIs** and **Public CLIs** decks, and live end-to-end checks now cover real install, update, and uninstall flows across both pip and npm packages. - **2026-04-14** 🧭 **Safari CLI** merged (#212) and added to the Hub registry — browser automation via `safari-mcp`. 🎬 **Kdenlive** also received compatibility fixes for Gen 5 project output and invalid project generation. @@ -307,6 +313,8 @@ cp CLI-Anything/opencode-commands/*.md .opencode/commands/ cp CLI-Anything/cli-anything-plugin/HARNESS.md .opencode/commands/ ``` +> **Note:** Please upgrade to the latest OpenCode. Older versions use `command/` (singular) instead of `commands/`. If `commands/` does not exist, use `command/` for both global and project-level installs. + > **Note:** `HARNESS.md` is the methodology spec that all commands reference. It must be in the same directory as the commands. This adds 5 slash commands: `/cli-anything`, `/cli-anything-refine`, `/cli-anything-test`, `/cli-anything-validate`, and `/cli-anything-list`. @@ -500,7 +508,7 @@ cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2e cli-anything-gimp ``` -Each installed CLI ships with a [`SKILL.md`](#-skillmd-generation) inside the Python package (`cli_anything//skills/SKILL.md`). The REPL banner automatically displays the absolute path to this file so AI agents know exactly where to read the skill definition. No extra configuration needed — `pip install` makes the skill discoverable. +Each in-repo harness now has a canonical [`SKILL.md`](#-skillmd-generation) at `skills/cli-anything-/SKILL.md`, which makes the monorepo directly discoverable via `npx skills add HKUDS/CLI-Anything --list`. Installed harness packages still ship a compatibility copy at `cli_anything//skills/SKILL.md`, and the REPL banner prefers the repo-root canonical file when present, falling back to the packaged copy otherwise. --- @@ -536,7 +544,7 @@ The agent will browse the catalog, install whichever CLI fits the task, and use The catalog auto-updates whenever `registry.json` changes — new community CLIs show up automatically. -> **For Claude Code users:** Copy [`cli-hub-meta-skill/SKILL.md`](cli-hub-meta-skill/SKILL.md) into your project or skills directory for the same automatic CLI discovery. +> **For Claude Code users:** Copy [`skills/cli-hub-meta-skill/SKILL.md`](skills/cli-hub-meta-skill/SKILL.md) into your project or skills directory for the same automatic CLI discovery. --- @@ -670,7 +678,7 @@ All CLIs organized under cli_anything.* namespace — conflict-free, pip-install ### 🤖 SKILL.md Generation -Each generated CLI includes a `SKILL.md` file inside the Python package at `cli_anything//skills/SKILL.md`. This self-contained skill definition enables AI agents to discover and use the CLI through Claude Code's skill system or other agent frameworks. +Each generated CLI now has a canonical `SKILL.md` at `skills/cli-anything-/SKILL.md`. This makes the current monorepo directly consumable by `npx skills`, while a packaged compatibility copy at `cli_anything//skills/SKILL.md` preserves installed-harness behavior. **What SKILL.md provides:** - **YAML frontmatter** with name and description for agent skill discovery @@ -678,7 +686,7 @@ Each generated CLI includes a `SKILL.md` file inside the Python package at `cli_ - **Usage examples** for common workflows - **Agent-specific guidance** for JSON output, error handling, and programmatic use -SKILL.md files are auto-generated during Phase 6.5 of the pipeline using `skill_generator.py`, which extracts metadata directly from the CLI's Click decorators, setup.py, and README. Because the file lives inside the package, it is installed alongside the CLI via `pip install` and auto-detected by the REPL banner — agents can read the absolute path displayed at startup. +SKILL.md files are auto-generated during Phase 6.5 of the pipeline using `skill_generator.py`, which extracts metadata directly from the CLI's Click decorators, setup.py, and README. The generator now writes the canonical repo-root skill file and refreshes the package-local compatibility copy used by installed harnesses. Inside this repo, the REPL banner points agents to the canonical root skill path; after `pip install`, it falls back to the packaged copy. --- diff --git a/adguardhome/agent-harness/cli_anything/adguardhome/utils/repl_skin.py b/adguardhome/agent-harness/cli_anything/adguardhome/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/adguardhome/agent-harness/cli_anything/adguardhome/utils/repl_skin.py +++ b/adguardhome/agent-harness/cli_anything/adguardhome/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/anygen/agent-harness/cli_anything/anygen/utils/repl_skin.py b/anygen/agent-harness/cli_anything/anygen/utils/repl_skin.py index a444e0458..bc1fb6d1d 100644 --- a/anygen/agent-harness/cli_anything/anygen/utils/repl_skin.py +++ b/anygen/agent-harness/cli_anything/anygen/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "anygen": "\033[38;5;141m", # soft violet } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -98,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -106,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -144,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -152,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -166,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -494,7 +562,6 @@ _ANSI_256_TO_HEX = { "\033[38;5;69m": "#5f87ff", # kdenlive slate blue "\033[38;5;75m": "#5fafff", # default sky blue "\033[38;5;80m": "#5fd7d7", # brand cyan - "\033[38;5;141m": "#af87ff", # anygen soft violet "\033[38;5;208m": "#ff8700", # blender deep orange "\033[38;5;214m": "#ffaf00", # gimp warm orange } diff --git a/audacity/agent-harness/cli_anything/audacity/utils/repl_skin.py b/audacity/agent-harness/cli_anything/audacity/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/audacity/agent-harness/cli_anything/audacity/utils/repl_skin.py +++ b/audacity/agent-harness/cli_anything/audacity/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/blender/agent-harness/cli_anything/blender/utils/repl_skin.py b/blender/agent-harness/cli_anything/blender/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/blender/agent-harness/cli_anything/blender/utils/repl_skin.py +++ b/blender/agent-harness/cli_anything/blender/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/browser/agent-harness/cli_anything/browser/utils/repl_skin.py b/browser/agent-harness/cli_anything/browser/utils/repl_skin.py index dab3acb5a..bc1fb6d1d 100644 --- a/browser/agent-harness/cli_anything/browser/utils/repl_skin.py +++ b/browser/agent-harness/cli_anything/browser/utils/repl_skin.py @@ -6,20 +6,21 @@ Copy this file into your CLI package at: Usage: from cli_anything..utils.repl_skin import ReplSkin - skin = ReplSkin("browser", version="1.0.0") - skin.print_banner() - prompt_text = skin.prompt(project_name="https://example.com", modified=False) - skin.success("Page loaded") - skin.error("Connection failed") - skin.warning("DOMShell not found") - skin.info("Navigating...") - skin.status("URL", "https://example.com") + skin = ReplSkin("shotcut", version="1.0.0") + skin.print_banner() # auto-detects repo-root or packaged SKILL.md + prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) + skin.success("Project saved") + skin.error("File not found") + skin.warning("Unsaved changes") + skin.info("Processing 24 clips...") + skin.status("Track 1", "3 clips, 00:02:30") skin.table(headers, rows) skin.print_goodbye() """ import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,8 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "ollama": "\033[38;5;255m", # white (Ollama branding) - "browser": "\033[38;5;141m", # lavender (browser harness) } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -59,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -91,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -99,23 +111,53 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: - software: Software name (e.g., "gimp", "shotcut", "browser"). + software: Software name (e.g., "gimp", "shotcut", "blender"). version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -145,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -153,10 +197,28 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") - # Title: ◆ cli-anything · Browser + # Title: ◆ cli-anything · Shotcut icon = self._c(_CYAN + _BOLD, "◆") brand = self._c(_CYAN + _BOLD, "cli-anything") dot = self._c(_DARK_GRAY, "·") @@ -167,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -301,7 +368,7 @@ class ReplSkin: print(f" {self._c(self.accent + _BOLD, title)}") print(f" {self._c(_DARK_GRAY, _H_LINE * len(title))}") - # ── Status display ─────────────────────────────────────────────── + # ── Status display ──────────────────────────────────────────────── def status(self, label: str, value: str): """Print a key-value status line.""" @@ -495,8 +562,6 @@ _ANSI_256_TO_HEX = { "\033[38;5;69m": "#5f87ff", # kdenlive slate blue "\033[38;5;75m": "#5fafff", # default sky blue "\033[38;5;80m": "#5fd7d7", # brand cyan - "\033[38;5;141m": "#afafff", # browser lavender "\033[38;5;208m": "#ff8700", # blender deep orange "\033[38;5;214m": "#ffaf00", # gimp warm orange - "\033[38;5;255m": "#eeeeee", # ollama white } diff --git a/chromadb/agent-harness/cli_anything/chromadb/utils/repl_skin.py b/chromadb/agent-harness/cli_anything/chromadb/utils/repl_skin.py index b356cb835..bc1fb6d1d 100644 --- a/chromadb/agent-harness/cli_anything/chromadb/utils/repl_skin.py +++ b/chromadb/agent-harness/cli_anything/chromadb/utils/repl_skin.py @@ -6,20 +6,21 @@ Copy this file into your CLI package at: Usage: from cli_anything..utils.repl_skin import ReplSkin - skin = ReplSkin("ollama", version="1.0.0") - skin.print_banner() - prompt_text = skin.prompt(project_name="llama3.2", modified=False) - skin.success("Model pulled") - skin.error("Connection failed") - skin.warning("No models loaded") - skin.info("Generating...") - skin.status("Model", "llama3.2:latest") + skin = ReplSkin("shotcut", version="1.0.0") + skin.print_banner() # auto-detects repo-root or packaged SKILL.md + prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) + skin.success("Project saved") + skin.error("File not found") + skin.warning("Unsaved changes") + skin.info("Processing 24 clips...") + skin.status("Track 1", "3 clips, 00:02:30") skin.table(headers, rows) skin.print_goodbye() """ import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "ollama": "\033[38;5;255m", # white (Ollama branding) } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -98,23 +111,53 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: - software: Software name (e.g., "gimp", "shotcut", "ollama"). + software: Software name (e.g., "gimp", "shotcut", "blender"). version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -144,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -152,10 +197,28 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") - # Title: ◆ cli-anything · Ollama + # Title: ◆ cli-anything · Shotcut icon = self._c(_CYAN + _BOLD, "◆") brand = self._c(_CYAN + _BOLD, "cli-anything") dot = self._c(_DARK_GRAY, "·") @@ -166,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -496,5 +564,4 @@ _ANSI_256_TO_HEX = { "\033[38;5;80m": "#5fd7d7", # brand cyan "\033[38;5;208m": "#ff8700", # blender deep orange "\033[38;5;214m": "#ffaf00", # gimp warm orange - "\033[38;5;255m": "#eeeeee", # ollama white } diff --git a/cli-anything-plugin/HARNESS.md b/cli-anything-plugin/HARNESS.md index 1a08bea0d..b96751cd8 100644 --- a/cli-anything-plugin/HARNESS.md +++ b/cli-anything-plugin/HARNESS.md @@ -79,7 +79,7 @@ designed for humans, without needing a display or mouse. from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("", version="1.0.0") - skin.print_banner() # Branded startup box (auto-detects skills/SKILL.md) + skin.print_banner() # Branded startup box (prefers repo-root skills/, falls back to package) pt_session = skin.create_prompt_session() # prompt_toolkit with history + styling line = skin.get_input(pt_session, project_name="my_project", modified=True) skin.help(commands_dict) # Formatted help listing @@ -92,8 +92,10 @@ designed for humans, without needing a display or mouse. skin.progress(3, 10, "...") # Progress bar skin.print_goodbye() # Styled exit message ``` - - ReplSkin auto-detects `skills/SKILL.md` inside the package directory and displays - it in the banner. AI agents can read the skill file at the displayed absolute path. + - ReplSkin prefers the repo-root canonical `skills/cli-anything-/SKILL.md` + when running inside this monorepo, and falls back to the packaged + `cli_anything//skills/SKILL.md` copy when installed elsewhere. + AI agents can read the skill file at the displayed absolute path. - Make REPL the default behavior: use `invoke_without_command=True` on the main Click group, and invoke the `repl` command when no subcommand is given: ```python @@ -257,8 +259,10 @@ automatically, or customize via the Jinja2 template at `templates/SKILL.md.templ See [`guides/skill-generation.md`](guides/skill-generation.md) for the full generation process, template customization options, and manual generation commands. -**Output Location:** SKILL.md lives inside the Python package at -`cli_anything//skills/SKILL.md` so it is installed with `pip install`. +**Output Location:** The canonical skill lives at +`skills/cli-anything-/SKILL.md`. A compatibility copy is also written to +`cli_anything//skills/SKILL.md` so installed harnesses still ship a +local skill file. **Key Principles:** @@ -270,9 +274,9 @@ process, template customization options, and manual generation commands. **Skill Path in CLI Banner:** -ReplSkin auto-detects `skills/SKILL.md` inside the package directory and displays -the absolute path in the startup banner. AI agents can read the skill file at the -displayed path to learn the CLI's full capabilities. +ReplSkin prefers the repo-root canonical skill path and falls back to the +packaged `skills/SKILL.md` copy. AI agents can read the displayed path to learn +the CLI's full capabilities. **Package Data:** Ensure `setup.py` includes the skill file so it ships with pip: diff --git a/cli-anything-plugin/README.md b/cli-anything-plugin/README.md index 5b223a39b..c5d58f0b8 100644 --- a/cli-anything-plugin/README.md +++ b/cli-anything-plugin/README.md @@ -219,7 +219,8 @@ Generate AI-discoverable skill definition: - Extract CLI metadata using `skill_generator.py` - Generate SKILL.md with YAML frontmatter (name, description) - Include command groups, examples, and agent-specific guidance -- Output to `cli_anything//skills/SKILL.md` (inside the Python package) +- Output canonical skill to `skills/cli-anything-/SKILL.md` +- Refresh package-local compatibility copy at `cli_anything//skills/SKILL.md` **Output:** SKILL.md file for AI agent discovery @@ -237,6 +238,10 @@ Package and install: ## Output Structure ``` +skills/ +└── cli-anything-/ + └── SKILL.md # Canonical repo-root skill for npx skills discovery + / └── agent-harness/ ├── .md # Software-specific SOP @@ -253,8 +258,6 @@ Package and install: │ ├── session.py # Undo/redo │ ├── export.py # Rendering/export │ └── ... # Domain-specific modules - ├── skills/ # AI-discoverable skill definition - │ └── SKILL.md # Installed with the package via package_data ├── utils/ # Utilities │ ├── __init__.py │ ├── repl_skin.py # Unified REPL skin (copy from plugin) @@ -323,6 +326,7 @@ The cli-anything methodology has successfully built CLIs for: - YAML frontmatter with name and description for triggering - Command groups and usage examples - Agent-specific guidance for programmatic usage +- Canonical repo-root `skills/` layout for `npx skills` discovery - Follows skill-creator methodology ### PyPI Distribution diff --git a/cli-anything-plugin/commands/cli-anything.md b/cli-anything-plugin/commands/cli-anything.md index 05ed8a710..9d61199f7 100644 --- a/cli-anything-plugin/commands/cli-anything.md +++ b/cli-anything-plugin/commands/cli-anything.md @@ -73,7 +73,7 @@ This command implements the complete cli-anything methodology to build a product - Extracts CLI metadata using `skill_generator.py` - Generates SKILL.md with YAML frontmatter and Markdown body - Includes command groups, examples, and agent-specific guidance -- Outputs to `cli_anything//skills/SKILL.md` inside the Python package +- Outputs the canonical skill to `skills/cli-anything-/SKILL.md` and refreshes the packaged compatibility copy at `cli_anything//skills/SKILL.md` - Makes the CLI discoverable and usable by AI agents ### Phase 7: PyPI Publishing and Installation @@ -100,8 +100,6 @@ This command implements the complete cli-anything methodology to build a product │ ├── session.py │ ├── export.py │ └── ... - ├── skills/ - │ └── SKILL.md # AI-discoverable skill definition ├── utils/ # Utilities └── tests/ ├── TEST.md # Test plan and results @@ -109,6 +107,14 @@ This command implements the complete cli-anything methodology to build a product └── test_full_e2e.py # E2E tests ``` +Canonical repo-root skill output: + +``` +skills/ +└── cli-anything-/ + └── SKILL.md +``` + ## Example ```bash diff --git a/cli-anything-plugin/guides/skill-generation.md b/cli-anything-plugin/guides/skill-generation.md index ea3f02a77..cf5fd0702 100644 --- a/cli-anything-plugin/guides/skill-generation.md +++ b/cli-anything-plugin/guides/skill-generation.md @@ -41,7 +41,7 @@ from skill_generator import generate_skill_file skill_path = generate_skill_file( harness_path="/path/to/agent-harness" ) -# Default output: cli_anything//skills/SKILL.md +# Default output: skills/cli-anything-/SKILL.md ``` ### 2. The generator automatically extracts: @@ -59,9 +59,14 @@ skill_path = generate_skill_file( ## Output Location -SKILL.md is generated inside the Python package so it is installed with `pip install`: +SKILL.md is generated canonically at the repo root, with a packaged compatibility +copy for installed harnesses: ``` +skills/ +└── cli-anything-/ + └── SKILL.md + / └── agent-harness/ └── cli_anything/ @@ -93,15 +98,16 @@ skill definition. ## Skill Path in CLI Banner -ReplSkin auto-detects `skills/SKILL.md` inside the package and displays the absolute -path in the startup banner. AI agents can read the file at the displayed path: +ReplSkin prefers the repo-root canonical skill file and falls back to the +packaged copy, displaying whichever absolute path is available in the startup +banner. AI agents can read the file at the displayed path: ```python # In the REPL initialization (e.g., shotcut_cli.py) from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("", version="1.0.0") -skin.print_banner() # Auto-detects and displays: ◇ Skill: /path/to/cli_anything//skills/SKILL.md +skin.print_banner() # Displays repo-root skills/cli-anything-/SKILL.md when available ``` ## Package Data diff --git a/cli-anything-plugin/repl_skin.py b/cli-anything-plugin/repl_skin.py index c7312348a..bc1fb6d1d 100644 --- a/cli-anything-plugin/repl_skin.py +++ b/cli-anything-plugin/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -106,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -156,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -164,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -178,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/cli-anything-plugin/skill_generator.py b/cli-anything-plugin/skill_generator.py index e4477d28e..80aeb53cf 100644 --- a/cli-anything-plugin/skill_generator.py +++ b/cli-anything-plugin/skill_generator.py @@ -22,6 +22,14 @@ def _format_display_name(name: str) -> str: return name.replace("_", " ").replace("-", " ").title() +def _canonical_skill_name(harness_path: Path, software_name: str) -> str: + """Return the repo-root canonical skill id for a harness.""" + software_dir = software_name + if harness_path.name == "agent-harness" and harness_path.parent.name: + software_dir = harness_path.parent.name + return f"cli-anything-{software_dir.replace('_', '-')}" + + @dataclass class CommandInfo: """Information about a CLI command.""" @@ -114,8 +122,13 @@ def extract_cli_metadata(harness_path: str) -> SkillMetadata: examples = generate_examples(software_name, command_groups) # Build skill name and description - skill_name = f"cli-anything-{software_name}" - skill_description = f"Command-line interface for {_format_display_name(software_name)} - {skill_intro[:100]}..." + skill_name = _canonical_skill_name(harness_path, software_name) + if skill_intro: + intro_snippet = skill_intro[:100] + suffix = "..." if len(skill_intro) > 100 else "" + skill_description = f"Command-line interface for {_format_display_name(software_name)} - {intro_snippet}{suffix}" + else: + skill_description = f"Command-line interface for {_format_display_name(software_name)}" return SkillMetadata( skill_name=skill_name, @@ -467,7 +480,8 @@ def generate_skill_file(harness_path: str, output_path: Optional[str] = None, Args: harness_path: Path to the agent-harness directory - output_path: Optional output path for SKILL.md (default: cli_anything//skills/SKILL.md) + output_path: Optional output path for SKILL.md + (default: skills/cli-anything-/SKILL.md) template_path: Optional path to custom Jinja2 template Returns: @@ -480,10 +494,11 @@ def generate_skill_file(harness_path: str, output_path: Optional[str] = None, content = generate_skill_md(metadata, template_path) # Determine output path + harness_path_obj = Path(harness_path) + compatibility_path = harness_path_obj / "cli_anything" / metadata.software_name / "skills" / "SKILL.md" if output_path is None: - # Default to skills/ directory under harness_path - harness_path_obj = Path(harness_path) - output_path = harness_path_obj / "cli_anything" / metadata.software_name / "skills" / "SKILL.md" + repo_root = harness_path_obj.parent.parent + output_path = repo_root / "skills" / metadata.skill_name / "SKILL.md" else: output_path = Path(output_path) @@ -492,6 +507,9 @@ def generate_skill_file(harness_path: str, output_path: Optional[str] = None, # Write file output_path.write_text(content, encoding="utf-8") + if compatibility_path != output_path: + compatibility_path.parent.mkdir(parents=True, exist_ok=True) + compatibility_path.write_text(content, encoding="utf-8") return str(output_path) @@ -509,7 +527,7 @@ if __name__ == "__main__": ) parser.add_argument( "-o", "--output", - help="Output path for SKILL.md (default: cli_anything//skills/SKILL.md)", + help="Output path for SKILL.md (default: skills/cli-anything-/SKILL.md)", default=None ) parser.add_argument( diff --git a/cli-anything-plugin/tests/test_skill_generator.py b/cli-anything-plugin/tests/test_skill_generator.py index e43475fd7..c2f7216d5 100644 --- a/cli-anything-plugin/tests/test_skill_generator.py +++ b/cli-anything-plugin/tests/test_skill_generator.py @@ -356,6 +356,9 @@ class TestEdgeCases: assert metadata.skill_intro == "" # No README → empty intro assert metadata.version == "1.0.0" assert metadata.command_groups == [] + # skill_description must not contain trailing " - ..." when intro is empty + assert " - " not in metadata.skill_description + assert not metadata.skill_description.endswith("...") def test_harness_with_system_package(self, tmp_path): """README with apt install instructions should extract system_package.""" diff --git a/cli-hub/tests/test_cli_hub.py b/cli-hub/tests/test_cli_hub.py index 71006c20e..f18b113a3 100644 --- a/cli-hub/tests/test_cli_hub.py +++ b/cli-hub/tests/test_cli_hub.py @@ -40,7 +40,7 @@ SAMPLE_REGISTRY = { "homepage": "https://gimp.org", "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=gimp/agent-harness", "entry_point": "cli-anything-gimp", - "skill_md": None, + "skill_md": "skills/cli-anything-gimp/SKILL.md", "category": "image", "contributor": "test-user", "contributor_url": "https://github.com/test-user", @@ -152,7 +152,6 @@ class TestRegistry: cats = list_categories() assert cats == ["3d", "audio", "image"] - # ─── Installer tests ────────────────────────────────────────────────── @@ -485,7 +484,6 @@ class TestScriptStrategy: assert data["jimeng"]["strategy"] == "command" assert data["jimeng"]["package_manager"] == "script" - # ─── Analytics tests ────────────────────────────────────────────────── @@ -686,6 +684,7 @@ class TestCLI: result = self.runner.invoke(main, ["info", "gimp"]) assert "GIMP" in result.output assert "image" in result.output + assert "Install: cli-hub install gimp" in result.output assert result.exit_code == 0 @patch("cli_hub.cli.track_first_run") diff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/repl_skin.py b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/repl_skin.py index c7312348a..bc1fb6d1d 100644 --- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/repl_skin.py +++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -106,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -156,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -164,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -178,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/cloudcompare/agent-harness/cli_anything/cloudcompare/utils/repl_skin.py b/cloudcompare/agent-harness/cli_anything/cloudcompare/utils/repl_skin.py index c7312348a..bc1fb6d1d 100644 --- a/cloudcompare/agent-harness/cli_anything/cloudcompare/utils/repl_skin.py +++ b/cloudcompare/agent-harness/cli_anything/cloudcompare/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -106,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -156,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -164,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -178,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/dify-workflow/agent-harness/cli_anything/dify_workflow/utils/repl_skin.py b/dify-workflow/agent-harness/cli_anything/dify_workflow/utils/repl_skin.py index c7312348a..bc1fb6d1d 100644 --- a/dify-workflow/agent-harness/cli_anything/dify_workflow/utils/repl_skin.py +++ b/dify-workflow/agent-harness/cli_anything/dify_workflow/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -106,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -156,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -164,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -178,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/docs/hub/index-modern.html b/docs/hub/index-modern.html index 0ba4b2a98..74a38dc49 100644 --- a/docs/hub/index-modern.html +++ b/docs/hub/index-modern.html @@ -258,6 +258,21 @@ flex-shrink: 0; } + .nav-link-stars { + display: inline-flex; + align-items: center; + justify-content: center; + min-width: 2.9rem; + padding: 0.14rem 0.52rem; + border-radius: 999px; + background: rgba(255, 255, 255, 0.08); + border: 1px solid rgba(255, 255, 255, 0.1); + color: var(--text); + font-size: 0.73rem; + font-variant-numeric: tabular-nums; + line-height: 1.1; + } + .theme-toggle { width: 42px; padding: 0; @@ -1334,12 +1349,13 @@ } .card-command-block { - padding: 0.9rem; + padding: 0.9rem 0.9rem 0.9rem 0.9rem; border-radius: 18px; border: 1px solid var(--border); background: linear-gradient(180deg, rgba(93, 168, 255, 0.07), rgba(255,255,255,0.02)), rgba(0,0,0,0.14); + position: relative; } .card--public .card-command-block { @@ -1365,15 +1381,32 @@ font-size: 0.8rem; color: var(--text); white-space: pre-wrap; - overflow-wrap: anywhere; - word-break: break-word; - line-height: 1.6; + overflow-wrap: break-word; + word-break: normal; + line-height: 1.45; + padding-top: 0.1rem; + } + + .card-command-comment { + display: block; + color: var(--text-tertiary); + font-style: italic; + margin-bottom: 0.24rem; + padding-right: 5.2rem; + } + + .card-command-line { + display: block; + } + + .card-command-line + .card-command-comment { + margin-top: 0.42rem; } .card-command-actions { - display: flex; - justify-content: flex-end; - margin-top: 0.7rem; + position: absolute; + top: 0.96rem; + right: 0.9rem; } .card-install-note { @@ -1485,15 +1518,13 @@ } .footer-copy a, - .footer-brand a, - .footer-analytics-link { + .footer-brand a { color: var(--text); text-decoration: none; } .footer-copy a:hover, - .footer-brand a:hover, - .footer-analytics-link:hover { + .footer-brand a:hover { text-decoration: underline; } @@ -1758,12 +1789,13 @@
- + SKILL.md GitHub + -- Contribute +
OpenClaw openclaw skills install cli-anything-hub @@ -1948,13 +1985,17 @@ Sort mode
Traffic Snapshot
- +
— visits @@ -2002,7 +2043,7 @@ · — AI agent - +
@@ -2034,6 +2075,8 @@ }); const REPO = 'https://github.com/HKUDS/CLI-Anything'; + const GITHUB_REPO_API = 'https://api.github.com/repos/HKUDS/CLI-Anything'; + const REPO_SKILLS_SOURCE = 'HKUDS/CLI-Anything'; const REGISTRY_URLS = [ '../../registry.json', 'https://raw.githubusercontent.com/HKUDS/CLI-Anything/main/registry.json' @@ -2059,7 +2102,7 @@ const deckState = { harness: { filter: 'all', sort: 'updated', query: '' }, - public: { filter: 'all', sort: 'name', query: '' }, + public: { filter: 'all', sort: 'updated', query: '' }, }; async function fetchJson(urls) { @@ -2074,6 +2117,34 @@ return null; } + function formatCompactCount(value) { + return new Intl.NumberFormat('en', { + notation: 'compact', + maximumFractionDigits: value >= 10000 ? 0 : 1, + }).format(value); + } + + async function loadGitHubStars() { + try { + const resp = await fetch(GITHUB_REPO_API, { + headers: { Accept: 'application/vnd.github+json' } + }); + if (!resp.ok) return; + + const repo = await resp.json(); + const stars = repo.stargazers_count; + if (typeof stars !== 'number') return; + + document.querySelectorAll('[data-github-stars]').forEach((el) => { + el.textContent = formatCompactCount(stars); + el.setAttribute('aria-label', stars.toLocaleString('en-US') + ' GitHub stars'); + el.title = stars.toLocaleString('en-US') + ' GitHub stars'; + }); + } catch (_) { + // Keep fallback placeholder when GitHub API is unavailable. + } + } + async function loadRegistries() { try { const [harnessData, publicData, dates] = await Promise.all([ @@ -2089,6 +2160,7 @@ if (publicData && publicData.clis) { publicClis = publicData.clis; + if (dates) publicClis.forEach((c) => { c.last_modified = dates[c.name]; }); } const totalClis = harnessClis.length + publicClis.length; @@ -2287,6 +2359,45 @@ grid.innerHTML = (deck === 'harness' ? filtered.map(renderHarnessCard) : filtered.map(renderPublicCard)).join(''); } + function repoSkillId(skillPath) { + if (!skillPath || skillPath.startsWith('http')) return ''; + const match = skillPath.match(/^skills\/([^/]+)\/SKILL\.md$/); + return match ? match[1] : ''; + } + + function normalizeNpxSkillsCmd(cmd) { + if (!cmd) return ''; + const trimmed = cmd.trim(); + if (!trimmed.startsWith('npx skills add ')) return ''; + return trimmed + .replace(/\s+-g\b/g, '') + .replace(/\s+-y\b/g, '') + .trim() + ' -g -y'; + } + + function harnessSkillCmd(c) { + const skillId = repoSkillId(c.skill_md); + return skillId ? 'npx skills add ' + REPO_SKILLS_SOURCE + ' --skill ' + skillId + ' -g -y' : ''; + } + + function publicSkillCmd(c) { + return normalizeNpxSkillsCmd(c.skill_md); + } + + function renderCommandStack(steps, sourceLabel) { + const display = steps.map((step) => + '# ' + esc(step.label.toLowerCase()) + '' + esc(step.cmd) + '' + ).join(''); + const copyText = steps.map((step) => + '# ' + step.label.toLowerCase() + '\n' + step.cmd + ).join('\n'); + return '
' + + '
Install Commands' + esc(sourceLabel) + '
' + + '
' + display + '
' + + '
' + + '
'; + } + function renderHarnessCard(c) { const requiresHtml = c.requires ? '
Requires ' + esc(c.requires) + '
' @@ -2310,6 +2421,12 @@ : ''; const dateHtml = c.last_modified ? '
Updated ' + esc(c.last_modified) + '
' : ''; const linksHtml = sourceLink + (skillLink ? skillLink : ''); + const installSteps = [ + { label: 'step 1 · install cli', cmd: 'cli-hub install ' + c.name, badge: 'CLI-Hub' } + ]; + const skillCmd = harnessSkillCmd(c); + if (skillCmd) installSteps.push({ label: 'step 2 · install skill', cmd: skillCmd, badge: 'npx skills' }); + const installBlock = renderCommandStack(installSteps, 'CLI-Hub'); return `
@@ -2326,16 +2443,7 @@ ${dateHtml} ${requiresHtml} -
-
- Install via CLI-Hub - PyPI -
-
pip install cli-anything-hub\ncli-hub install ${esc(c.name)}
-
- -
-
+ ${installBlock}
${linksHtml}
${contributorHtml} @@ -2356,6 +2464,7 @@ function renderPublicCard(c) { const isBundled = (c.install_strategy || c.package_manager) === 'bundled'; + const dateHtml = c.last_modified ? '
Updated ' + esc(c.last_modified) + '
' : ''; const requiresHtml = c.requires ? '
Requires ' + esc(c.requires) + '
' : ''; @@ -2374,13 +2483,14 @@ ? '
Direct command: ' + esc(directCmd) + '
' : ''; const installNotesHtml = c.install_notes ? '
' + esc(c.install_notes) + '
' : ''; + const installSteps = isBundled + ? [] + : [{ label: 'step 1 · install cli', cmd: 'cli-hub install ' + c.name, badge: 'CLI-Hub' }]; + const skillCmd = publicSkillCmd(c); + if (skillCmd) installSteps.push({ label: 'step 2 · install skill', cmd: skillCmd, badge: 'npx skills' }); const installBlock = isBundled ? '
Bundled with the upstream application. Install or update the parent app and enable its CLI integration.
' - : '
' + - '
Install via CLI-HubSource aware
' + - '
pip install cli-anything-hub\ncli-hub install ' + esc(c.name) + '
' + - '
' + - '
'; + : renderCommandStack(installSteps, 'Source aware'); return `
@@ -2394,6 +2504,7 @@
${titleHtml}
${esc(c.description)}
+ ${dateHtml} ${requiresHtml} ${directCmdHtml} ${installNotesHtml} @@ -2511,48 +2622,47 @@ const UMAMI_API = 'https://api.umami.is/v1'; const UMAMI_KEY = 'api_idAebMhzn6z0hsUQT7BSxRuCK2GUZvRY'; - const WEBSITE_IDS = [ - '07082d05-efd3-4f85-a7a1-b426b0e8bfaa', - 'a076c661-bed1-405c-a522-813794e688b4', - ]; + const HKUDS_WEBSITE_ID = '07082d05-efd3-4f85-a7a1-b426b0e8bfaa'; + const CC_WEBSITE_ID = 'a076c661-bed1-405c-a522-813794e688b4'; const headers = { Accept: 'application/json', 'x-umami-api-key': UMAMI_KEY }; async function loadVisitorStats() { try { const now = Date.now(); - let totalVisits = 0; - let humanCount = 0; - const fetches = WEBSITE_IDS.flatMap((id) => [ - fetch(UMAMI_API + '/websites/' + id + '/stats?startAt=0&endAt=' + now, { headers }), - fetch(UMAMI_API + '/websites/' + id + '/events/series?startAt=0&endAt=' + now + '&unit=year&timezone=UTC', { headers }) + let hkudsHumanVisits = 0; + let ccHumanVisits = 0; + let ccAgentVisits = 0; + const [hkudsStatsResp, ccEventsResp] = await Promise.all([ + fetch(UMAMI_API + '/websites/' + HKUDS_WEBSITE_ID + '/stats?startAt=0&endAt=' + now, { headers }), + fetch(UMAMI_API + '/websites/' + CC_WEBSITE_ID + '/events/series?startAt=0&endAt=' + now + '&unit=year&timezone=UTC', { headers }) ]); - const [statsResp1, eventsResp1, statsResp2, eventsResp2] = await Promise.all(fetches); - for (const resp of [statsResp1, statsResp2]) { - if (resp.ok) { - const stats = await resp.json(); - totalVisits += stats.visits ?? 0; - } + if (hkudsStatsResp.ok) { + const stats = await hkudsStatsResp.json(); + hkudsHumanVisits = stats.visits ?? 0; } - for (const resp of [eventsResp1, eventsResp2]) { - if (resp.ok) { - const events = await resp.json(); - events.forEach((e) => { - if (e.x === 'visit-human') humanCount += e.y || 0; - }); - } + if (ccEventsResp.ok) { + const events = await ccEventsResp.json(); + events.forEach((e) => { + if (e.x === 'visit-human') ccHumanVisits += e.y || 0; + if (e.x === 'visit-agent') ccAgentVisits += e.y || 0; + }); } + const humanCount = hkudsHumanVisits + ccHumanVisits; + const totalVisits = humanCount + ccAgentVisits; + document.getElementById('stat-total').textContent = totalVisits.toLocaleString(); document.getElementById('stat-human').textContent = humanCount.toLocaleString(); - document.getElementById('stat-agent').textContent = Math.max(0, totalVisits - humanCount).toLocaleString(); + document.getElementById('stat-agent').textContent = ccAgentVisits.toLocaleString(); } catch (_) { // Leave fallback dashes. } } loadVisitorStats(); + loadGitHubStars(); })(); diff --git a/docs/hub/index.html b/docs/hub/index.html index 0b1597487..5e853b05c 100644 --- a/docs/hub/index.html +++ b/docs/hub/index.html @@ -17,6 +17,8 @@ --text: #fafafa; --text-secondary: #a1a1aa; --text-tertiary: #71717a; + --hero-neutral-top: #e7ecf2; + --hero-neutral-bottom: #b8c1cd; --accent: #3b82f6; --accent-muted: #2563eb; --green: #22c55e; @@ -37,6 +39,8 @@ --text: #09090b; --text-secondary: #52525b; --text-tertiary: #71717a; + --hero-neutral-top: #7f8894; + --hero-neutral-bottom: #a8b1bc; --accent: #2563eb; --accent-muted: #1d4ed8; --green: #16a34a; @@ -103,6 +107,21 @@ .nav-link svg { width: 15px; height: 15px; flex-shrink: 0; } + .nav-link-stars { + display: inline-flex; + align-items: center; + justify-content: center; + min-width: 2.8rem; + padding: 0.1rem 0.45rem; + border-radius: 999px; + border: 1px solid var(--border); + background: var(--surface); + color: var(--text); + font-size: 0.72rem; + font-variant-numeric: tabular-nums; + line-height: 1.1; + } + /* ── Theme toggle ── */ .theme-toggle { display: inline-flex; @@ -139,16 +158,119 @@ text-align: center; } + .hero-title { + display: inline-flex; + align-items: center; + justify-content: center; + gap: 0.95rem; + margin-bottom: 0.82rem; + position: relative; + } + + .hero-title-badge { + position: relative; + width: 3.25rem; + height: 3.25rem; + display: inline-flex; + align-items: center; + justify-content: center; + border-radius: 12px; + border: 1px solid rgba(148, 163, 184, 0.12); + background: + linear-gradient(180deg, rgba(255, 255, 255, 0.035), rgba(255, 255, 255, 0.008)), + linear-gradient(135deg, rgba(59, 130, 246, 0.08), transparent 42%), + var(--surface); + box-shadow: + inset 0 1px 0 rgba(255, 255, 255, 0.05), + inset 0 -1px 0 rgba(255, 255, 255, 0.02), + 0 14px 34px rgba(2, 6, 23, 0.2); + overflow: hidden; + backdrop-filter: blur(8px); + -webkit-backdrop-filter: blur(8px); + } + + .hero-title-badge::before { + content: ''; + position: absolute; + inset: 0; + border-radius: inherit; + background: linear-gradient(180deg, rgba(255,255,255,0.04), transparent 36%, transparent 100%); + pointer-events: none; + } + + .hero-title-badge svg { + width: 2.26rem; + height: 2.26rem; + overflow: visible; + } + .hero h1 { font-size: 2.8rem; font-weight: 800; letter-spacing: -0.02em; line-height: 1.15; - margin-bottom: 0.6rem; + margin: 0; + display: inline-flex; + align-items: baseline; + gap: 0.18em; + flex-wrap: wrap; + justify-content: center; + } + + .hero-word { + display: inline-block; + will-change: transform, opacity; + } + + .js .hero-word { + opacity: 0; + transform: translateY(18px); + } + + .motion-ready .hero-word--cli { + animation: hero-rise-in 0.72s cubic-bezier(0.2, 0.9, 0.2, 1) 0.06s both; + } + + .motion-ready .hero-word--anything { + animation: hero-rise-in 0.82s cubic-bezier(0.2, 0.9, 0.2, 1) 0.18s both; + } + + .motion-ready .hero-word--hub { + animation: hero-drop-in 0.8s cubic-bezier(0.2, 0.9, 0.2, 1) 0.34s both; } .hero-accent { color: var(--accent); } - .hero-dim { color: var(--text-tertiary); } + .hero-dim { + color: var(--hero-neutral-bottom); + background: linear-gradient(180deg, var(--hero-neutral-top) 0%, var(--hero-neutral-bottom) 100%); + -webkit-background-clip: text; + background-clip: text; + -webkit-text-fill-color: transparent; + opacity: 0.9; + } + + .hero-shimmer { + position: relative; + isolation: isolate; + } + + .hero-shimmer::after { + content: attr(data-text); + position: absolute; + inset: 0; + color: transparent; + background: linear-gradient(115deg, transparent 22%, rgba(255,255,255,0.94) 48%, transparent 72%); + background-size: 220% 100%; + background-position: 145% 50%; + -webkit-background-clip: text; + background-clip: text; + opacity: 0; + pointer-events: none; + } + + .motion-ready .hero-shimmer::after { + animation: hero-shimmer-pass 1.25s ease-out 0.66s 1 both; + } .hero-tagline { font-size: 1.15rem; @@ -156,10 +278,138 @@ line-height: 1.6; max-width: 700px; margin: 0 auto 1.5rem; + letter-spacing: 0; + text-align: center; + white-space: normal; + } + + .hero-tagline-line { + display: inline; + } + + .js .hero-tagline-line { + opacity: 0; + transform: translateY(10px); + } + + .hero-tagline-line--any { + color: var(--text); + font-weight: 600; + } + + .motion-ready .hero-tagline-line--any { + animation: hero-tagline-in 0.62s ease-out 0.5s both; + } + + .motion-ready .hero-tagline-line--rest { + animation: hero-tagline-in 0.62s ease-out 0.64s both; } .hero-tagline strong { color: var(--text); font-weight: 600; } + .motion-ready .hero-title-badge { + animation: hero-badge-in 0.68s cubic-bezier(0.2, 0.9, 0.2, 1) 0.02s both; + } + + .motion-ready .hero-title-badge svg { + animation: hero-badge-float 4.2s ease-in-out 1.1s infinite; + } + + .motion-ready .hero-badge-glow { + animation: hero-badge-pulse 4.2s ease-in-out 1.1s infinite; + } + + .motion-ready .hero-badge-cursor { + animation: hero-badge-cursor 1.1s steps(1) infinite; + } + + @keyframes hero-rise-in { + from { + opacity: 0; + transform: translateY(18px); + } + to { + opacity: 1; + transform: translateY(0); + } + } + + @keyframes hero-drop-in { + from { + opacity: 0; + transform: translateY(-16px); + } + to { + opacity: 1; + transform: translateY(0); + } + } + + @keyframes hero-tagline-in { + from { + opacity: 0; + transform: translateY(10px); + } + to { + opacity: 1; + transform: translateY(0); + } + } + + @keyframes hero-badge-in { + from { + opacity: 0; + transform: translateY(10px) scale(0.94); + } + to { + opacity: 1; + transform: translateY(0) scale(1); + } + } + + @keyframes hero-badge-float { + 0%, 100% { transform: translateY(0); } + 50% { transform: translateY(-3px); } + } + + @keyframes hero-badge-pulse { + 0%, 100% { opacity: 0.3; } + 50% { opacity: 0.88; } + } + + @keyframes hero-badge-cursor { + 0%, 48% { opacity: 1; } + 49%, 100% { opacity: 0.18; } + } + + @keyframes hero-shimmer-pass { + 0% { + opacity: 0; + background-position: 145% 50%; + } + 12% { + opacity: 0.92; + } + 78% { + opacity: 0.92; + } + 100% { + opacity: 0; + background-position: -55% 50%; + } + } + + @keyframes hero-stats-in { + from { + opacity: 0; + transform: translateY(12px); + } + to { + opacity: 1; + transform: translateY(0); + } + } + /* ── Empower card ── */ .empower-row { display: flex; @@ -206,7 +456,7 @@ background: var(--bg); border: 1px solid var(--border); border-radius: var(--radius-sm); - padding: 0.45rem 0.75rem; + padding: 0.52rem 0.75rem; margin-bottom: 0.5rem; } @@ -222,6 +472,32 @@ text-overflow: ellipsis; } + .install-row--wrap { + align-items: flex-start; + } + + .install-row--wrap code { + white-space: normal; + overflow: visible; + text-overflow: clip; + overflow-wrap: anywhere; + word-break: break-word; + line-height: 1.45; + padding-top: 0.08rem; + } + + .empower-note { + margin-top: 0.25rem; + font-size: 0.76rem; + color: var(--text-tertiary); + line-height: 1.5; + } + + .empower-note strong { + color: var(--text-secondary); + font-weight: 600; + } + .empower-prompt { margin-top: 0.85rem; padding: 0.6rem 0.85rem; @@ -237,7 +513,7 @@ .empower-prompt em { color: var(--accent); font-style: italic; } .empower-available { - margin: 0.25rem 0 0.5rem; + margin: 0.25rem 0 0.7rem; font-size: 0.78rem; color: var(--text-tertiary); } @@ -246,31 +522,147 @@ .empower-card.empower-self::before { background: var(--green); } .empower-card.empower-self h3 span { color: var(--green); } + .typing-shell { + position: relative; + margin-bottom: 0.9rem; + padding: 0.8rem 0.92rem 0.88rem; + background: + linear-gradient(180deg, rgba(34, 197, 94, 0.06) 0%, rgba(34, 197, 94, 0.015) 100%), + radial-gradient(circle at top right, rgba(59, 130, 246, 0.14), transparent 42%), + var(--bg); + border: 1px solid rgba(63, 63, 70, 0.95); + border-radius: 11px; + overflow: hidden; + box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.03), 0 12px 28px rgba(0, 0, 0, 0.16); + } + .typing-shell::before { + content: ''; + position: absolute; + inset: 0; + background: linear-gradient(180deg, rgba(255, 255, 255, 0.035), transparent 22%, transparent 78%, rgba(255, 255, 255, 0.025)); + pointer-events: none; + } + .typing-shell-head { + display: flex; + align-items: center; + justify-content: space-between; + gap: 0.75rem; + margin-bottom: 0.56rem; + position: relative; + z-index: 1; + } + .typing-shell-label { + display: inline-flex; + align-items: center; + gap: 0.42rem; + color: var(--text-tertiary); + font-size: 0.68rem; + font-style: italic; + letter-spacing: 0.06em; + text-transform: uppercase; + } + .typing-shell-label::before { + content: ''; + width: 0.42rem; + height: 0.42rem; + border-radius: 999px; + background: var(--green); + box-shadow: 0 0 14px rgba(34, 197, 94, 0.55); + flex-shrink: 0; + } + .typing-shell-copy { + position: relative; + z-index: 1; + } + .typing-shell-body { + position: relative; + z-index: 1; + display: flex; + align-items: center; + gap: 0.65rem; + min-height: 2.5rem; + padding: 0.76rem 0.82rem; + border-radius: 9px; + border: 1px solid rgba(63, 63, 70, 0.92); + background: linear-gradient(180deg, rgba(9, 9, 11, 0.74), rgba(9, 9, 11, 0.94)); + } + .typing-shell-prompt { + color: var(--green); + font-family: 'JetBrains Mono', monospace; + font-size: 0.82rem; + font-weight: 500; + text-shadow: 0 0 16px rgba(34, 197, 94, 0.25); + flex-shrink: 0; + } + .typing-shell-code { + flex: 1; + min-width: 0; + display: inline-flex; + align-items: center; + font-family: 'JetBrains Mono', monospace; + font-size: 0.8rem; + color: #d4d4d8; + letter-spacing: -0.01em; + white-space: nowrap; + overflow: hidden; + } + .typing-shell-text { + display: inline-block; + min-height: 1em; + } + .typing-shell-cursor { + width: 0.62ch; + height: 1.1em; + margin-left: 0.1rem; + border-radius: 1px; + background: linear-gradient(180deg, #fafafa, #a1a1aa); + box-shadow: 0 0 14px rgba(255, 255, 255, 0.2); + animation: typing-caret 1s steps(1) infinite; + flex-shrink: 0; + } + .typing-shell-subtitle { + position: relative; + z-index: 1; + margin-top: 0.55rem; + color: var(--text-tertiary); + font-size: 0.73rem; + font-style: italic; + line-height: 1.45; + } + @keyframes typing-caret { + 0%, 48% { opacity: 1; } + 49%, 100% { opacity: 0.2; } + } .empower-self .cmd-grid { display: grid; grid-template-columns: 1fr 1fr; - gap: 0.4rem; + gap: 0.38rem; } .empower-self .cmd-item { - display: flex; - align-items: center; - gap: 0.4rem; + display: grid; + grid-template-rows: auto auto; + align-content: start; + gap: 0.1rem; background: var(--bg); border: 1px solid var(--border); border-radius: var(--radius-sm); - padding: 0.4rem 0.65rem; - font-size: 0.76rem; + padding: 0.42rem 0.64rem 0.44rem; + min-height: 3.12rem; } .empower-self .cmd-item:hover { border-color: var(--text-tertiary); } .empower-self .cmd-item .cmd-name { color: var(--green); font-family: 'JetBrains Mono', monospace; font-weight: 500; + font-size: 0.76rem; + line-height: 1.18; white-space: nowrap; } .empower-self .cmd-item .cmd-desc { color: var(--text-tertiary); - font-size: 0.72rem; + font-size: 0.68rem; + line-height: 1.22; + letter-spacing: -0.01em; } .hero-actions { @@ -347,23 +739,56 @@ .hero-cta a:hover { text-decoration: underline; } .stats { - display: flex; + display: inline-flex; + align-items: flex-start; justify-content: center; - gap: 3rem; - margin-top: 1.75rem; + gap: 0; + margin: 0.45rem auto 1.45rem; + } + + .js .stats { + opacity: 0; + transform: translateY(12px); + } + + .motion-ready .stats { + animation: hero-stats-in 0.66s cubic-bezier(0.2, 0.9, 0.2, 1) 0.78s both; + } + + .stat { + min-width: 8.5rem; + padding: 0 1.55rem; + position: relative; + text-align: center; + } + + .stat + .stat::before { + content: ''; + position: absolute; + left: 0; + top: 0.2rem; + bottom: 0.2rem; + width: 1px; + background: linear-gradient(180deg, transparent, rgba(148, 163, 184, 0.32), transparent); } .stat-num { - font-size: 2rem; - font-weight: 700; + font-size: 2.7rem; + line-height: 1; + font-weight: 800; + letter-spacing: -0.045em; color: var(--accent); + font-variant-numeric: tabular-nums; + text-shadow: 0 10px 28px rgba(37, 99, 235, 0.16); } .stat-label { - font-size: 0.78rem; + margin-top: 0.38rem; + font-size: 0.73rem; color: var(--text-tertiary); text-transform: uppercase; - letter-spacing: 0.05em; + letter-spacing: 0.09em; + font-weight: 600; } .chip-label { @@ -400,6 +825,16 @@ border-top: 1px solid var(--border-subtle); } + .marketplace-prelude { + max-width: 1200px; + margin: 0 auto; + padding: 0.9rem 1.5rem 0; + } + + .marketplace-prelude .typing-shell { + margin-bottom: 0; + } + /* ── Deck system ── */ .deck-stage { --deck-peek: 72px; @@ -792,11 +1227,8 @@ background: var(--bg); border: 1px solid var(--border); border-radius: var(--radius-sm); - padding: 0.45rem 0.65rem; - display: flex; - align-items: center; - justify-content: space-between; - gap: 0.5rem; + padding: 0.8rem 0.9rem 0.8rem 0.9rem; + position: relative; margin-bottom: 0.75rem; } @@ -808,11 +1240,28 @@ font-family: 'JetBrains Mono', monospace; font-size: 0.75rem; color: var(--text-secondary); - white-space: pre-line; - overflow: hidden; - text-overflow: ellipsis; - flex: 1; - line-height: 1.6; + white-space: pre-wrap; + overflow-wrap: break-word; + word-break: normal; + line-height: 1.45; + display: block; + padding-top: 0.1rem; + } + + .card-install code .install-comment { + display: block; + color: var(--text-tertiary); + font-style: italic; + margin-bottom: 0.22rem; + padding-right: 4.8rem; + } + + .card-install code .install-command { + display: block; + } + + .card-install code .install-command + .install-comment { + margin-top: 0.38rem; } .card-copy-btn { @@ -828,6 +1277,12 @@ white-space: nowrap; } + .card-install .card-copy-btn { + position: absolute; + top: 0.78rem; + right: 0.72rem; + } + .card-copy-btn:hover { color: var(--text); border-color: var(--text-tertiary); } .card-footer { @@ -846,16 +1301,93 @@ gap: 0.6rem; font-size: 0.78rem; flex-wrap: wrap; + align-items: center; } - .card-links a { + .card-links a, + .card-link-btn { color: var(--text-tertiary); text-decoration: none; font-weight: 500; transition: color 0.15s; } - .card-links a:hover { color: var(--text-secondary); } + .card-link-btn { + background: none; + border: 0; + cursor: pointer; + font: inherit; + padding: 0; + } + + .card-links a:hover, + .card-link-btn:hover { color: var(--text-secondary); } + + .skill-popover { + position: relative; + display: inline-flex; + align-items: center; + } + + .skill-popover-panel { + position: absolute; + left: 0; + top: calc(100% + 0.45rem); + width: min(18rem, calc(100vw - 3rem)); + padding: 0.7rem; + border-radius: 10px; + border: 1px solid rgba(148, 163, 184, 0.36); + background: rgba(248, 250, 252, 0.98); + color: #0f172a; + box-shadow: 0 16px 32px rgba(15, 23, 42, 0.24); + opacity: 0; + transform: translateY(-4px); + pointer-events: none; + transition: opacity 0.16s ease, transform 0.16s ease; + z-index: 10; + } + + .skill-popover.is-open .skill-popover-panel { + opacity: 1; + transform: translateY(0); + pointer-events: auto; + } + + .skill-popover-label { + display: block; + font-size: 0.64rem; + font-weight: 700; + letter-spacing: 0.08em; + text-transform: uppercase; + color: #475569; + margin-bottom: 0.45rem; + } + + .skill-popover-panel code { + display: block; + font-size: 0.75rem; + line-height: 1.55; + white-space: pre-wrap; + overflow-wrap: anywhere; + word-break: break-word; + font-family: 'JetBrains Mono', monospace; + background: rgba(226, 232, 240, 0.7); + border: 1px solid rgba(148, 163, 184, 0.3); + border-radius: 8px; + padding: 0.55rem 0.6rem; + } + + .skill-popover-copy { + margin-top: 0.55rem; + color: #334155; + border-color: rgba(100, 116, 139, 0.34); + background: rgba(255, 255, 255, 0.72); + } + + .skill-popover-copy:hover { + color: #0f172a; + border-color: rgba(51, 65, 85, 0.42); + } .card-contributor { font-size: 0.75rem; @@ -1058,16 +1590,9 @@ gap: 0.4rem; font-size: 0.78rem; color: var(--text-tertiary); - text-decoration: none; padding: 0.35rem 0.75rem; border: 1px solid var(--border); border-radius: 999px; - transition: border-color 0.15s, color 0.15s; - } - - .footer-analytics-link:hover { - border-color: var(--text-tertiary); - color: var(--text-secondary); } .footer-analytics-link svg { opacity: 0.6; flex-shrink: 0; } @@ -1100,6 +1625,38 @@ .deck-stage { --deck-peek: 46px; } .hero { padding: 2rem 1.25rem 1.5rem; } .hero h1 { font-size: 2rem; } + .hero-title { + gap: 0.72rem; + align-items: flex-start; + } + .hero-title-badge { + width: 2.7rem; + height: 2.7rem; + border-radius: 11px; + } + .hero-title-badge svg { + width: 1.84rem; + height: 1.84rem; + } + .stats { + display: flex; + width: 100%; + justify-content: center; + gap: 0; + } + .stat { + min-width: 0; + flex: 1; + padding: 0 1rem; + } + .stat + .stat::before { + top: 0.1rem; + bottom: 0.1rem; + } + .stat-num { + font-size: 2.2rem; + } + .hero-tagline { white-space: normal; } .grid { grid-template-columns: 1fr; padding: 0 1.25rem; } .controls { padding: 1rem 1.25rem 0; } .filter-row { @@ -1112,10 +1669,15 @@ margin-right: calc(var(--deck-peek) * 0.5); padding-right: 1.25rem; } + .marketplace-prelude { padding: 0.75rem 1.25rem 0; } .nav { padding: 0.75rem 1.25rem; } .footer { padding: 1.5rem 1.25rem; flex-direction: column; align-items: flex-start; } .empower-row { flex-direction: column; } .empower-card { margin: 0 0 1rem; padding: 1.25rem; } + .typing-shell { padding: 0.72rem 0.78rem 0.8rem; } + .typing-shell-head { align-items: flex-start; } + .typing-shell-body { padding: 0.72rem 0.74rem; } + .typing-shell-code { font-size: 0.74rem; } .empower-self .cmd-grid { grid-template-columns: 1fr; } .deck-nav { padding: 1.25rem 1.25rem 0; } .deck-arrow-btn span { display: none; } @@ -1131,7 +1693,24 @@ .nav-links { gap: 0; } .nav-link { padding: 0.4rem 0.4rem; font-size: 0.75rem; } } + + @media (prefers-reduced-motion: reduce) { + .hero-word, + .hero-tagline-line { + opacity: 1; + transform: none; + } + + .hero-shimmer::after, + .hero-title-badge, + .hero-badge-glow, + .hero-badge-cursor, + .typing-shell-cursor { + animation: none !important; + } + } + @@ -1152,6 +1731,7 @@ GitHub + -- Contribute @@ -1165,23 +1745,51 @@
-

CLI-Anything Hub

-

Any software. Any codebase. Any Web API. Generate an agent-native CLI and let AI agents operate it — install with a single pip command.

+
+ +

+ CLI- + Anything + Hub +

+
+

Any software. Any codebase. Any Web API. Generate an agent-native CLI and let AI agents operate it — install with a single command.

+
+
+
—
+
CLIs Available
+
+
+
—
+
Categories
+
+

Empower your agents — install in one command

-

Available on: ClawHub, SkillHub, SkillHub.cn

-
- OpenClaw - openclaw skills install cli-anything-hub - -
-
- nanobot - nanobot skills install cli-anything-hub - +

Also Available on: ClawHub, SkillHub, SkillHub.cn

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

Works with: OpenClaw, Nanobot, Claude Code, Codex, Antigravity, and other SKILL-compatible agents.

Then prompt: "Find appropriate CLI software in CLI-Hub and complete the task: ..."
@@ -1189,17 +1797,18 @@

Empower yourself — your CLI toolkit

-
+
+ pip pip install cli-anything-hub
-
cli-hub listBrowse all CLIs
-
cli-hub searchFind by keyword
-
cli-hub installInstall (pip or npm)
-
cli-hub infoCLI details
-
cli-hub updateUpdate a CLI
-
cli-hub uninstallRemove a CLI
+
cli-hub listBrowse the registry
+
cli-hub searchSearch by keyword
+
cli-hub installInstall from CLI-Hub
+
cli-hub infoInspect one CLI
+
cli-hub updateUpdate an install
+
cli-hub uninstallRemove an install
@@ -1222,14 +1831,17 @@

We welcome contributions for any application — desktop apps, dev tools, cloud services, SaaS APIs, creative suites, and beyond. If it has a GUI or an API, it deserves an agent-native CLI. Read the Contributing Guide, use the PR Template, and bring it to the hub!

-
-
-
—
-
CLIs Available
+
+ +
+
+
+ install first, then browse the marketplace +
-
-
—
-
Categories
+
+ $ +
@@ -1275,6 +1887,7 @@
@@ -1299,7 +1912,7 @@ Powered by CLI-Anything
- +
— visits @@ -1309,7 +1922,7 @@ · — AI agent - +
@@ -1343,6 +1956,8 @@ }); const REPO = 'https://github.com/HKUDS/CLI-Anything'; + const GITHUB_REPO_API = 'https://api.github.com/repos/HKUDS/CLI-Anything'; + const REPO_SKILLS_SOURCE = 'HKUDS/CLI-Anything'; const REGISTRY_URLS = [ '../../registry.json', 'https://raw.githubusercontent.com/HKUDS/CLI-Anything/main/registry.json' @@ -1372,7 +1987,7 @@ // Per-deck state const deckState = { harness: { filter: 'all', sort: 'updated', query: '' }, - public: { filter: 'all', sort: 'name', query: '' }, + public: { filter: 'all', sort: 'updated', query: '' }, }; async function fetchJson(urls) { @@ -1385,6 +2000,34 @@ return null; } + function formatCompactCount(value) { + return new Intl.NumberFormat('en', { + notation: 'compact', + maximumFractionDigits: value >= 10000 ? 0 : 1, + }).format(value); + } + + async function loadGitHubStars() { + try { + const resp = await fetch(GITHUB_REPO_API, { + headers: { 'Accept': 'application/vnd.github+json' } + }); + if (!resp.ok) return; + + const repo = await resp.json(); + const stars = repo.stargazers_count; + if (typeof stars !== 'number') return; + + document.querySelectorAll('[data-github-stars]').forEach(el => { + el.textContent = formatCompactCount(stars); + el.setAttribute('aria-label', `${stars.toLocaleString('en-US')} GitHub stars`); + el.title = `${stars.toLocaleString('en-US')} GitHub stars`; + }); + } catch (_) { + // Keep fallback placeholder when GitHub API is unavailable. + } + } + async function loadRegistries() { try { const [harnessData, publicData, dates] = await Promise.all([ @@ -1400,13 +2043,14 @@ if (publicData && publicData.clis) { publicClis = publicData.clis; + if (dates) publicClis.forEach(c => c.last_modified = dates[c.name]); } // Update counts const totalClis = harnessClis.length + publicClis.length; const allCategories = [...new Set([...harnessClis, ...publicClis].map(c => c.category))]; - document.getElementById('cli-count').textContent = totalClis; - document.getElementById('category-count').textContent = allCategories.length; + animateCount(document.getElementById('cli-count'), totalClis, 980); + animateCount(document.getElementById('category-count'), allCategories.length, 860); document.getElementById('deck-count-harness').textContent = harnessClis.length; document.getElementById('deck-count-public').textContent = publicClis.length; @@ -1623,6 +2267,71 @@ } } + function repoSkillId(skillPath) { + if (!skillPath || skillPath.startsWith('http')) return ''; + const match = skillPath.match(/^skills\/([^/]+)\/SKILL\.md$/); + return match ? match[1] : ''; + } + + function isWebUrl(value) { + return /^https?:\/\//i.test(value || ''); + } + + function isRepoSkillPath(value) { + return !/\s/.test(value || '') && /(^\.{0,2}\/|\/|\.md$|\.txt$)/i.test(value || ''); + } + + function normalizeNpxSkillsCmd(cmd) { + if (!cmd) return ''; + const trimmed = cmd.trim(); + if (!trimmed.startsWith('npx skills add ')) return ''; + return trimmed + .replace(/\s+-g\b/g, '') + .replace(/\s+-y\b/g, '') + .trim() + ' -g -y'; + } + + function harnessSkillCmd(c) { + const skillId = repoSkillId(c.skill_md); + return skillId ? `npx skills add ${REPO_SKILLS_SOURCE} --skill ${skillId} -g -y` : ''; + } + + function publicSkillCmd(c) { + return normalizeNpxSkillsCmd(c.skill_md); + } + + function renderSkillAction(value) { + if (!value) return ''; + if (isWebUrl(value)) { + return `Skill`; + } + if (isRepoSkillPath(value)) { + return `Skill`; + } + return ` + + + + Skill install + ${esc(value)} + + + `; + } + + function renderInstallStack(steps) { + const display = steps.map((step) => + `# ${esc(step.label.toLowerCase())}${esc(step.cmd)}` + ).join(''); + const copyText = steps.map((step) => + `# ${step.label.toLowerCase()}\n${step.cmd}` + ).join('\n'); + return `
+ ${display} + +
`; + } + function renderHarnessCard(c) { const requiresHtml = c.requires ? `
Requires ${esc(c.requires)}
` @@ -1646,6 +2355,12 @@ const dateHtml = c.last_modified ? `
Updated ${esc(c.last_modified)}
` : ''; + const installSteps = [ + { label: 'step 1 · install cli', cmd: `cli-hub install ${c.name}` } + ]; + const skillCmd = harnessSkillCmd(c); + if (skillCmd) installSteps.push({ label: 'step 2 · install skill', cmd: skillCmd }); + const installHtml = renderInstallStack(installSteps); return `
@@ -1659,10 +2374,7 @@
${esc(c.description)}
${dateHtml} ${requiresHtml} -
- pip install cli-anything-hub\ncli-hub install ${esc(c.name)} - -
+ ${installHtml}
${sourceLink}${skillLink ? ' · ' + skillLink : ''}
${contributorHtml} @@ -1683,12 +2395,16 @@ function renderNpmCard(c) { const isBundled = (c.install_strategy || c.package_manager) === 'bundled'; + const dateHtml = c.last_modified + ? `
Updated ${esc(c.last_modified)}
` + : ''; const requiresHtml = c.requires ? `
Requires ${esc(c.requires)}
` : ''; const titleHtml = c.homepage ? `${esc(c.display_name)}${EXTERNAL_LINK_SVG}` : esc(c.display_name); + const skillLink = renderSkillAction(c.skill_md); const sourceLink = c.source_url ? `Source` : ''; @@ -1708,12 +2424,15 @@ const publicNotesHtml = (directCmdHtml || installNotesHtml) ? `
${directCmdHtml}${installNotesHtml}
` : ''; + const installSteps = isBundled + ? [] + : [{ label: 'step 1 · install cli', cmd: `cli-hub install ${c.name}` }]; + const skillCmd = publicSkillCmd(c); + if (skillCmd) installSteps.push({ label: 'step 2 · install skill', cmd: skillCmd }); const cliHubInstallHtml = isBundled ? `
Bundled with the upstream app
` - : `
- pip install cli-anything-hub\ncli-hub install ${esc(c.name)} - -
`; + : renderInstallStack(installSteps); + const linksHtml = [sourceLink, skillLink].filter(Boolean).join(' · '); return `
@@ -1725,11 +2444,12 @@
${esc(c.description)}
+ ${dateHtml} ${requiresHtml} ${cliHubInstallHtml} ${publicNotesHtml}
-
${sourceLink}
+
${linksHtml}
${contributorHtml}
`; @@ -1742,6 +2462,78 @@ }); } + function initHeroMotion() { + if (window.matchMedia('(prefers-reduced-motion: reduce)').matches) { + document.documentElement.classList.remove('js'); + return; + } + window.requestAnimationFrame(() => { + document.documentElement.classList.add('motion-ready'); + }); + } + + function animateCount(el, target, duration = 900) { + if (!el) return; + const finalValue = Number(target) || 0; + + if (window.matchMedia('(prefers-reduced-motion: reduce)').matches) { + el.textContent = finalValue; + return; + } + + const start = performance.now(); + + function step(now) { + const progress = Math.min((now - start) / duration, 1); + const eased = 1 - Math.pow(1 - progress, 3); + el.textContent = Math.round(finalValue * eased); + if (progress < 1) { + window.requestAnimationFrame(step); + } else { + el.textContent = finalValue; + } + } + + window.requestAnimationFrame(step); + } + + function initHeroTypingBar() { + const shell = document.querySelector('[data-typing-text]'); + if (!shell) return; + const target = shell.querySelector('[data-typing-target]'); + const fullText = shell.dataset.typingText || ''; + if (!target || !fullText) return; + + if (window.matchMedia('(prefers-reduced-motion: reduce)').matches) { + target.textContent = fullText; + return; + } + + let index = 0; + let deleting = false; + + function tick() { + target.textContent = fullText.slice(0, index); + + let delay = deleting ? 44 : 86; + if (!deleting && index < fullText.length) { + index += 1; + } else if (!deleting && index === fullText.length) { + deleting = true; + delay = 1650; + } else if (deleting && index > 0) { + index -= 1; + } else { + deleting = false; + delay = 480; + } + + window.setTimeout(tick, delay); + } + + window.setTimeout(tick, 420); + } + function esc(s) { if (!s) return ''; const d = document.createElement('div'); @@ -1749,6 +2541,62 @@ return d.innerHTML; } + function escAttr(s) { + if (!s) return ''; + return String(s) + .replace(/&/g, '&') + .replace(/"/g, '"') + .replace(//g, '>'); + } + + function toggleSkillPopover(trigger) { + const popover = trigger.closest('.skill-popover'); + if (!popover) return; + const shouldOpen = !popover.classList.contains('is-open'); + document.querySelectorAll('.skill-popover.is-open').forEach((node) => { + node.classList.remove('is-open'); + const btn = node.querySelector('.skill-trigger'); + if (btn) btn.setAttribute('aria-expanded', 'false'); + }); + if (!shouldOpen) return; + popover.classList.add('is-open'); + trigger.setAttribute('aria-expanded', 'true'); + } + + document.addEventListener('click', (e) => { + const copyBtn = e.target.closest('.skill-popover-copy'); + if (copyBtn) { + e.preventDefault(); + e.stopPropagation(); + copyCmd(copyBtn, copyBtn.dataset.copyValue); + return; + } + + const trigger = e.target.closest('.skill-trigger'); + if (trigger) { + e.preventDefault(); + e.stopPropagation(); + toggleSkillPopover(trigger); + return; + } + + document.querySelectorAll('.skill-popover.is-open').forEach((node) => { + node.classList.remove('is-open'); + const btn = node.querySelector('.skill-trigger'); + if (btn) btn.setAttribute('aria-expanded', 'false'); + }); + }); + + document.addEventListener('keydown', (e) => { + if (e.key !== 'Escape') return; + document.querySelectorAll('.skill-popover.is-open').forEach((node) => { + node.classList.remove('is-open'); + const btn = node.querySelector('.skill-trigger'); + if (btn) btn.setAttribute('aria-expanded', 'false'); + }); + }); + // Wire up search and sort for each deck document.getElementById('search-harness').addEventListener('input', (e) => { deckState.harness.query = e.target.value; @@ -1770,6 +2618,8 @@ window.addEventListener('resize', updateDeckPosition); initDeckGestures(); + initHeroMotion(); + initHeroTypingBar(); loadRegistries().then(updateDeckPosition); // ── Visitor classification: human vs AI agent ── @@ -1855,49 +2705,48 @@ // ── Fetch all-time stats from Umami Cloud API (both sites) ── const UMAMI_API = 'https://api.umami.is/v1'; const UMAMI_KEY = 'api_idAebMhzn6z0hsUQT7BSxRuCK2GUZvRY'; - const WEBSITE_IDS = [ - '07082d05-efd3-4f85-a7a1-b426b0e8bfaa', // hkuds.github.io - 'a076c661-bed1-405c-a522-813794e688b4', // clianything.cc - ]; + const HKUDS_WEBSITE_ID = '07082d05-efd3-4f85-a7a1-b426b0e8bfaa'; + const CC_WEBSITE_ID = 'a076c661-bed1-405c-a522-813794e688b4'; const headers = { 'Accept': 'application/json', 'x-umami-api-key': UMAMI_KEY }; async function loadVisitorStats() { try { const now = Date.now(); - let totalVisits = 0, humanCount = 0; + let hkudsHumanVisits = 0; + let ccHumanVisits = 0; + let ccAgentVisits = 0; - // Fetch stats and events from both sites in parallel - const fetches = WEBSITE_IDS.flatMap(id => [ - fetch(`${UMAMI_API}/websites/${id}/stats?startAt=0&endAt=${now}`, { headers }), - fetch(`${UMAMI_API}/websites/${id}/events/series?startAt=0&endAt=${now}&unit=year&timezone=UTC`, { headers }) + const [hkudsStatsResp, ccEventsResp] = await Promise.all([ + fetch(`${UMAMI_API}/websites/${HKUDS_WEBSITE_ID}/stats?startAt=0&endAt=${now}`, { headers }), + fetch(`${UMAMI_API}/websites/${CC_WEBSITE_ID}/events/series?startAt=0&endAt=${now}&unit=year&timezone=UTC`, { headers }) ]); - const [statsResp1, eventsResp1, statsResp2, eventsResp2] = await Promise.all(fetches); - for (const resp of [statsResp1, statsResp2]) { - if (resp.ok) { - const stats = await resp.json(); - totalVisits += stats.visits ?? 0; - } + if (hkudsStatsResp.ok) { + const stats = await hkudsStatsResp.json(); + hkudsHumanVisits = stats.visits ?? 0; } - for (const resp of [eventsResp1, eventsResp2]) { - if (resp.ok) { - const events = await resp.json(); - events.forEach(e => { - if (e.x === 'visit-human') humanCount += e.y || 0; - }); - } + if (ccEventsResp.ok) { + const events = await ccEventsResp.json(); + events.forEach(e => { + if (e.x === 'visit-human') ccHumanVisits += e.y || 0; + if (e.x === 'visit-agent') ccAgentVisits += e.y || 0; + }); } + const humanCount = hkudsHumanVisits + ccHumanVisits; + const totalVisits = humanCount + ccAgentVisits; + document.getElementById('stat-total').textContent = totalVisits.toLocaleString(); document.getElementById('stat-human').textContent = humanCount.toLocaleString(); - document.getElementById('stat-agent').textContent = Math.max(0, totalVisits - humanCount).toLocaleString(); + document.getElementById('stat-agent').textContent = ccAgentVisits.toLocaleString(); } catch (_) { // Stats not available — leave dashes } } loadVisitorStats(); + loadGitHubStars(); })(); diff --git a/drawio/agent-harness/cli_anything/drawio/utils/repl_skin.py b/drawio/agent-harness/cli_anything/drawio/utils/repl_skin.py index 93e2f352f..bc1fb6d1d 100644 --- a/drawio/agent-harness/cli_anything/drawio/utils/repl_skin.py +++ b/drawio/agent-harness/cli_anything/drawio/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "drawio": "\033[38;5;202m", # draw.io orange } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -98,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -106,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -144,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -152,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -166,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -495,6 +563,5 @@ _ANSI_256_TO_HEX = { "\033[38;5;75m": "#5fafff", # default sky blue "\033[38;5;80m": "#5fd7d7", # brand cyan "\033[38;5;208m": "#ff8700", # blender deep orange - "\033[38;5;202m": "#ff5f00", # drawio orange "\033[38;5;214m": "#ffaf00", # gimp warm orange } diff --git a/eth2-quickstart/agent-harness/cli_anything/eth2_quickstart/utils/repl_skin.py b/eth2-quickstart/agent-harness/cli_anything/eth2_quickstart/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/eth2-quickstart/agent-harness/cli_anything/eth2_quickstart/utils/repl_skin.py +++ b/eth2-quickstart/agent-harness/cli_anything/eth2_quickstart/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/exa/agent-harness/cli_anything/exa/skills/SKILL.md b/exa/agent-harness/cli_anything/exa/skills/SKILL.md index 68d19fb66..70a4e81a4 100644 --- a/exa/agent-harness/cli_anything/exa/skills/SKILL.md +++ b/exa/agent-harness/cli_anything/exa/skills/SKILL.md @@ -1,3 +1,9 @@ +--- +name: "cli-anything-exa" +description: >- + Agent-native CLI for Exa web search and content retrieval workflows. +--- + # Exa CLI Skill ## Identity diff --git a/exa/agent-harness/cli_anything/exa/utils/repl_skin.py b/exa/agent-harness/cli_anything/exa/utils/repl_skin.py index c7312348a..6792ec1a1 100644 --- a/exa/agent-harness/cli_anything/exa/utils/repl_skin.py +++ b/exa/agent-harness/cli_anything/exa/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -106,21 +106,32 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + software_aliases = {"iterm2_ctl": "iterm2"} + skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / f"cli-anything-{skill_slug}" / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) diff --git a/freecad/agent-harness/cli_anything/freecad/utils/repl_skin.py b/freecad/agent-harness/cli_anything/freecad/utils/repl_skin.py index 962c97bb8..bc1fb6d1d 100644 --- a/freecad/agent-harness/cli_anything/freecad/utils/repl_skin.py +++ b/freecad/agent-harness/cli_anything/freecad/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "freecad": "\033[38;5;196m", # FreeCAD red } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -107,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -157,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -165,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -179,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -518,6 +563,5 @@ _ANSI_256_TO_HEX = { "\033[38;5;75m": "#5fafff", # default sky blue "\033[38;5;80m": "#5fd7d7", # brand cyan "\033[38;5;208m": "#ff8700", # blender deep orange - "\033[38;5;196m": "#ff0000", # freecad red "\033[38;5;214m": "#ffaf00", # gimp warm orange } diff --git a/gimp/agent-harness/cli_anything/gimp/utils/repl_skin.py b/gimp/agent-harness/cli_anything/gimp/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/gimp/agent-harness/cli_anything/gimp/utils/repl_skin.py +++ b/gimp/agent-harness/cli_anything/gimp/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/godot/agent-harness/cli_anything/godot/skills/SKILL.md b/godot/agent-harness/cli_anything/godot/skills/SKILL.md index 75e0cc065..bf48161e2 100644 --- a/godot/agent-harness/cli_anything/godot/skills/SKILL.md +++ b/godot/agent-harness/cli_anything/godot/skills/SKILL.md @@ -1,3 +1,9 @@ +--- +name: "cli-anything-godot" +description: >- + Agent-native CLI for Godot project management, scenes, exports, and script execution. +--- + # Godot Engine CLI Agent-native CLI for the Godot game engine. Manage projects, scenes, exports, and GDScript execution from the command line. diff --git a/godot/agent-harness/cli_anything/godot/utils/repl_skin.py b/godot/agent-harness/cli_anything/godot/utils/repl_skin.py index c7312348a..bc1fb6d1d 100644 --- a/godot/agent-harness/cli_anything/godot/utils/repl_skin.py +++ b/godot/agent-harness/cli_anything/godot/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -106,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -156,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -164,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -178,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/inkscape/agent-harness/cli_anything/inkscape/utils/repl_skin.py b/inkscape/agent-harness/cli_anything/inkscape/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/inkscape/agent-harness/cli_anything/inkscape/utils/repl_skin.py +++ b/inkscape/agent-harness/cli_anything/inkscape/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/intelwatch/agent-harness/cli_anything/intelwatch/utils/repl_skin.py b/intelwatch/agent-harness/cli_anything/intelwatch/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/intelwatch/agent-harness/cli_anything/intelwatch/utils/repl_skin.py +++ b/intelwatch/agent-harness/cli_anything/intelwatch/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/iterm2/agent-harness/cli_anything/iterm2_ctl/utils/repl_skin.py b/iterm2/agent-harness/cli_anything/iterm2_ctl/utils/repl_skin.py index c7312348a..bc1fb6d1d 100644 --- a/iterm2/agent-harness/cli_anything/iterm2_ctl/utils/repl_skin.py +++ b/iterm2/agent-harness/cli_anything/iterm2_ctl/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -106,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -156,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -164,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -178,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/kdenlive/agent-harness/cli_anything/kdenlive/utils/repl_skin.py b/kdenlive/agent-harness/cli_anything/kdenlive/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/kdenlive/agent-harness/cli_anything/kdenlive/utils/repl_skin.py +++ b/kdenlive/agent-harness/cli_anything/kdenlive/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/krita/agent-harness/cli_anything/krita/utils/repl_skin.py b/krita/agent-harness/cli_anything/krita/utils/repl_skin.py index c3fd1db2f..bc1fb6d1d 100644 --- a/krita/agent-harness/cli_anything/krita/utils/repl_skin.py +++ b/krita/agent-harness/cli_anything/krita/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "krita": "\033[38;5;98m", # purple (Krita brand) } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -107,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -157,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -165,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -179,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -516,7 +561,6 @@ _ANSI_256_TO_HEX = { "\033[38;5;55m": "#5f00af", # obs purple "\033[38;5;69m": "#5f87ff", # kdenlive slate blue "\033[38;5;75m": "#5fafff", # default sky blue - "\033[38;5;98m": "#875fd7", # krita purple "\033[38;5;80m": "#5fd7d7", # brand cyan "\033[38;5;208m": "#ff8700", # blender deep orange "\033[38;5;214m": "#ffaf00", # gimp warm orange diff --git a/libreoffice/agent-harness/cli_anything/libreoffice/utils/repl_skin.py b/libreoffice/agent-harness/cli_anything/libreoffice/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/libreoffice/agent-harness/cli_anything/libreoffice/utils/repl_skin.py +++ b/libreoffice/agent-harness/cli_anything/libreoffice/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/mermaid/agent-harness/cli_anything/mermaid/utils/repl_skin.py b/mermaid/agent-harness/cli_anything/mermaid/utils/repl_skin.py index 5de4ac420..b1f805711 100644 --- a/mermaid/agent-harness/cli_anything/mermaid/utils/repl_skin.py +++ b/mermaid/agent-harness/cli_anything/mermaid/utils/repl_skin.py @@ -2,18 +2,61 @@ from __future__ import annotations +import os +from pathlib import Path +import textwrap + from prompt_toolkit import PromptSession from prompt_toolkit.auto_suggest import AutoSuggestFromHistory from prompt_toolkit.history import InMemoryHistory +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + + +def _display_home_path(path: str) -> str: + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + class ReplSkin: - def __init__(self, software: str, version: str = "1.0.0"): + def __init__(self, software: str, version: str = "1.0.0", skill_path: str | None = None): self.software = software self.version = version + self.skill_slug = self.software.replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + self.skill_path = skill_path or self._detect_skill_path() + + def _detect_skill_path(self) -> str | None: + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + return str(candidate) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + if package_skill.is_file(): + return str(package_skill) + return None def print_banner(self) -> None: print(f"cli-anything-{self.software} v{self.version}") + install_lines = textwrap.wrap( + self.skill_install_cmd, width=88, break_long_words=True, break_on_hyphens=False + ) or [self.skill_install_cmd] + for index, line in enumerate(install_lines): + prefix = "Install: " if index == 0 else " " + print(f"{prefix}{line}") + print(f"Global skill: {_display_home_path(self.global_skill_path)}") print("Type help for commands, quit to exit") def create_prompt_session(self) -> PromptSession: diff --git a/mubu/agent-harness/cli_anything/mubu/utils/repl_skin.py b/mubu/agent-harness/cli_anything/mubu/utils/repl_skin.py index c7312348a..bc1fb6d1d 100644 --- a/mubu/agent-harness/cli_anything/mubu/utils/repl_skin.py +++ b/mubu/agent-harness/cli_anything/mubu/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -106,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -156,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -164,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -178,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/mubu/agent-harness/skill_generator.py b/mubu/agent-harness/skill_generator.py index 9b272b7a2..a00c2a9c3 100644 --- a/mubu/agent-harness/skill_generator.py +++ b/mubu/agent-harness/skill_generator.py @@ -237,7 +237,12 @@ def extract_cli_metadata(harness_path: str) -> SkillMetadata: command_groups = extract_commands_from_cli(cli_file) if cli_file.exists() else [] examples = generate_examples(software_name, command_groups) skill_name = f"cli-anything-{software_name}" - skill_description = f"Command-line interface for {_format_display_name(software_name)} - {skill_intro[:100]}..." + if skill_intro: + intro_snippet = skill_intro[:100] + suffix = "..." if len(skill_intro) > 100 else "" + skill_description = f"Command-line interface for {_format_display_name(software_name)} - {intro_snippet}{suffix}" + else: + skill_description = f"Command-line interface for {_format_display_name(software_name)}" return SkillMetadata( skill_name=skill_name, @@ -399,12 +404,18 @@ def generate_skill_md(metadata: SkillMetadata, template_path: Optional[str] = No def generate_skill_file(harness_path: str, output_path: Optional[str] = None, template_path: Optional[str] = None) -> str: metadata = extract_cli_metadata(harness_path) content = generate_skill_md(metadata, template_path) + harness_root = Path(harness_path) + skill_id = f"cli-anything-{harness_root.parent.name.replace('_', '-')}" if output_path is None: - output = Path(harness_path) / "cli_anything" / metadata.software_name / "skills" / "SKILL.md" + output = harness_root.parent.parent / "skills" / skill_id / "SKILL.md" else: output = Path(output_path) + mirror = harness_root / "cli_anything" / metadata.software_name / "skills" / "SKILL.md" output.parent.mkdir(parents=True, exist_ok=True) output.write_text(content, encoding="utf-8") + if mirror != output: + mirror.parent.mkdir(parents=True, exist_ok=True) + mirror.write_text(content, encoding="utf-8") return str(output) diff --git a/musescore/agent-harness/cli_anything/musescore/utils/repl_skin.py b/musescore/agent-harness/cli_anything/musescore/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/musescore/agent-harness/cli_anything/musescore/utils/repl_skin.py +++ b/musescore/agent-harness/cli_anything/musescore/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/n8n/agent-harness/cli_anything/n8n/utils/repl_skin.py b/n8n/agent-harness/cli_anything/n8n/utils/repl_skin.py index be7e0751e..73cf49665 100644 --- a/n8n/agent-harness/cli_anything/n8n/utils/repl_skin.py +++ b/n8n/agent-harness/cli_anything/n8n/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("n8n", version="2.4.7") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_workflow", modified=True) skin.success("Workflow activated") skin.error("Connection failed") @@ -22,6 +22,7 @@ import json import os import shutil import sys +from pathlib import Path from typing import Any import click @@ -63,6 +64,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -95,6 +98,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -112,27 +126,43 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + self.skill_slug = self.software.replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -162,7 +192,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -170,6 +202,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -184,19 +234,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/novita/agent-harness/cli_anything/novita/utils/repl_skin.py b/novita/agent-harness/cli_anything/novita/utils/repl_skin.py index 68d5a179a..bc1fb6d1d 100644 --- a/novita/agent-harness/cli_anything/novita/utils/repl_skin.py +++ b/novita/agent-harness/cli_anything/novita/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -30,7 +31,7 @@ _ITALIC = "\033[3m" _UNDERLINE = "\033[4m" # Brand colors -_CYAN = "\033[38;5;80m" # cli-anything brand cyan +_CYAN = "\033[38;5;80m" # cli-anything brand cyan _CYAN_BG = "\033[48;5;80m" _WHITE = "\033[97m" _GRAY = "\033[38;5;245m" @@ -39,18 +40,16 @@ _LIGHT_GRAY = "\033[38;5;250m" # Software accent colors — each software gets a unique accent _ACCENT_COLORS = { - "gimp": "\033[38;5;214m", # warm orange - "blender": "\033[38;5;208m", # deep orange - "inkscape": "\033[38;5;39m", # bright blue - "audacity": "\033[38;5;33m", # navy blue - "libreoffice": "\033[38;5;40m", # green - "obs_studio": "\033[38;5;55m", # purple - "kdenlive": "\033[38;5;69m", # slate blue - "shotcut": "\033[38;5;35m", # teal green - "anygen": "\033[38;5;141m", # soft violet - "novita": "\033[38;5;81m", # vivid blue (for Novita AI) + "gimp": "\033[38;5;214m", # warm orange + "blender": "\033[38;5;208m", # deep orange + "inkscape": "\033[38;5;39m", # bright blue + "audacity": "\033[38;5;33m", # navy blue + "libreoffice": "\033[38;5;40m", # green + "obs_studio": "\033[38;5;55m", # purple + "kdenlive": "\033[38;5;69m", # slate blue + "shotcut": "\033[38;5;35m", # teal green } -_DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue +_DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue # Status colors _GREEN = "\033[38;5;78m" @@ -59,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -83,7 +84,6 @@ _CROSS = "┼" def _strip_ansi(text: str) -> str: """Remove ANSI escape codes for length calculation.""" import re - return re.sub(r"\033\[[^m]*m", "", text) @@ -92,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -99,9 +110,8 @@ class ReplSkin: across all CLI harnesses built with the cli-anything methodology. """ - def __init__( - self, software: str, version: str = "1.0.0", history_file: str | None = None - ): + def __init__(self, software: str, version: str = "1.0.0", + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -109,16 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path - hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -148,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -156,10 +197,28 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") - # Title: ◆ cli-anything · Novita + # Title: ◆ cli-anything · Shotcut icon = self._c(_CYAN + _BOLD, "◆") brand = self._c(_CYAN + _BOLD, "cli-anything") dot = self._c(_DARK_GRAY, "·") @@ -170,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -180,9 +244,8 @@ class ReplSkin: # ── Prompt ──────────────────────────────────────────────────────── - def prompt( - self, project_name: str = "", modified: bool = False, context: str = "" - ) -> str: + def prompt(self, project_name: str = "", modified: bool = False, + context: str = "") -> str: """Build a styled prompt string for prompt_toolkit or input(). Args: @@ -210,15 +273,14 @@ class ReplSkin: mod = "*" if modified else "" parts.append(f" {self._c(_DARK_GRAY, '[')}") parts.append(self._c(_LIGHT_GRAY, f"{ctx}{mod}")) - parts.append(self._c(_DARK_GRAY, "]")) + parts.append(self._c(_DARK_GRAY, ']')) parts.append(self._c(_GRAY, " ❯ ")) return "".join(parts) - def prompt_tokens( - self, project_name: str = "", modified: bool = False, context: str = "" - ): + def prompt_tokens(self, project_name: str = "", modified: bool = False, + context: str = ""): """Build prompt_toolkit formatted text tokens for the prompt. Use with prompt_toolkit's FormattedText for proper ANSI handling. @@ -256,25 +318,23 @@ class ReplSkin: accent_hex = _ANSI_256_TO_HEX.get(self.accent, "#5fafff") - return Style.from_dict( - { - "icon": "#5fdfdf bold", # cyan brand color - "software": f"{accent_hex} bold", - "bracket": "#585858", - "context": "#bcbcbc", - "arrow": "#808080", - # Completion menu - "completion-menu.completion": "bg:#303030 #bcbcbc", - "completion-menu.completion.current": f"bg:{accent_hex} #000000", - "completion-menu.meta.completion": "bg:#303030 #808080", - "completion-menu.meta.completion.current": f"bg:{accent_hex} #000000", - # Auto-suggest - "auto-suggest": "#585858", - # Bottom toolbar - "bottom-toolbar": "bg:#1c1c1c #808080", - "bottom-toolbar.text": "#808080", - } - ) + return Style.from_dict({ + "icon": "#5fdfdf bold", # cyan brand color + "software": f"{accent_hex} bold", + "bracket": "#585858", + "context": "#bcbcbc", + "arrow": "#808080", + # Completion menu + "completion-menu.completion": "bg:#303030 #bcbcbc", + "completion-menu.completion.current": f"bg:{accent_hex} #000000", + "completion-menu.meta.completion": "bg:#303030 #808080", + "completion-menu.meta.completion.current": f"bg:{accent_hex} #000000", + # Auto-suggest + "auto-suggest": "#585858", + # Bottom toolbar + "bottom-toolbar": "bg:#1c1c1c #808080", + "bottom-toolbar.text": "#808080", + }) # ── Messages ────────────────────────────────────────────────────── @@ -351,7 +411,8 @@ class ReplSkin: # ── Table display ───────────────────────────────────────────────── - def table(self, headers: list[str], rows: list[list[str]], max_col_width: int = 40): + def table(self, headers: list[str], rows: list[list[str]], + max_col_width: int = 40): """Print a formatted table with box-drawing characters. Args: @@ -377,7 +438,8 @@ class ReplSkin: # Header header_cells = [ - self._c(_CYAN + _BOLD, pad(h, col_widths[i])) for i, h in enumerate(headers) + self._c(_CYAN + _BOLD, pad(h, col_widths[i])) + for i, h in enumerate(headers) ] sep = self._c(_DARK_GRAY, f" {_V_LINE} ") header_line = f" {sep.join(header_cells)}" @@ -385,9 +447,7 @@ class ReplSkin: # Separator sep_parts = [self._c(_DARK_GRAY, _H_LINE * w) for w in col_widths] - sep_line = self._c( - _DARK_GRAY, f" {'───'.join([_H_LINE * w for w in col_widths])}" - ) + sep_line = self._c(_DARK_GRAY, f" {'───'.join([_H_LINE * w for w in col_widths])}") print(sep_line) # Rows @@ -447,13 +507,8 @@ class ReplSkin: except ImportError: return None - def get_input( - self, - pt_session, - project_name: str = "", - modified: bool = False, - context: str = "", - ) -> str: + def get_input(self, pt_session, project_name: str = "", + modified: bool = False, context: str = "") -> str: """Get input from user using prompt_toolkit or fallback. Args: @@ -467,7 +522,6 @@ class ReplSkin: """ if pt_session is not None: from prompt_toolkit.formatted_text import FormattedText - tokens = self.prompt_tokens(project_name, modified, context) return pt_session.prompt(FormattedText(tokens)).strip() else: @@ -485,10 +539,8 @@ class ReplSkin: Returns: A callable that returns FormattedText for the toolbar. """ - def toolbar(): from prompt_toolkit.formatted_text import FormattedText - parts = [] for i, (k, v) in enumerate(items.items()): if i > 0: @@ -496,23 +548,20 @@ class ReplSkin: parts.append(("class:bottom-toolbar.text", f" {k}: ")) parts.append(("class:bottom-toolbar", v)) return FormattedText(parts) - return toolbar # ── ANSI 256-color to hex mapping (for prompt_toolkit styles) ───────── _ANSI_256_TO_HEX = { - "\033[38;5;33m": "#0087ff", # audacity navy blue - "\033[38;5;35m": "#00af5f", # shotcut teal - "\033[38;5;39m": "#00afff", # inkscape bright blue - "\033[38;5;40m": "#00d700", # libreoffice green - "\033[38;5;55m": "#5f00af", # obs purple - "\033[38;5;69m": "#5f87ff", # kdenlive slate blue - "\033[38;5;75m": "#5fafff", # default sky blue - "\033[38;5;80m": "#5fd7d7", # brand cyan - "\033[38;5;81m": "#5fd7ff", # novita vivid blue - "\033[38;5;141m": "#af87ff", # anygen soft violet + "\033[38;5;33m": "#0087ff", # audacity navy blue + "\033[38;5;35m": "#00af5f", # shotcut teal + "\033[38;5;39m": "#00afff", # inkscape bright blue + "\033[38;5;40m": "#00d700", # libreoffice green + "\033[38;5;55m": "#5f00af", # obs purple + "\033[38;5;69m": "#5f87ff", # kdenlive slate blue + "\033[38;5;75m": "#5fafff", # default sky blue + "\033[38;5;80m": "#5fd7d7", # brand cyan "\033[38;5;208m": "#ff8700", # blender deep orange "\033[38;5;214m": "#ffaf00", # gimp warm orange } diff --git a/obs-studio/agent-harness/cli_anything/obs_studio/utils/repl_skin.py b/obs-studio/agent-harness/cli_anything/obs_studio/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/obs-studio/agent-harness/cli_anything/obs_studio/utils/repl_skin.py +++ b/obs-studio/agent-harness/cli_anything/obs_studio/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/obsidian/agent-harness/cli_anything/obsidian/utils/repl_skin.py b/obsidian/agent-harness/cli_anything/obsidian/utils/repl_skin.py index b356cb835..bc1fb6d1d 100644 --- a/obsidian/agent-harness/cli_anything/obsidian/utils/repl_skin.py +++ b/obsidian/agent-harness/cli_anything/obsidian/utils/repl_skin.py @@ -6,20 +6,21 @@ Copy this file into your CLI package at: Usage: from cli_anything..utils.repl_skin import ReplSkin - skin = ReplSkin("ollama", version="1.0.0") - skin.print_banner() - prompt_text = skin.prompt(project_name="llama3.2", modified=False) - skin.success("Model pulled") - skin.error("Connection failed") - skin.warning("No models loaded") - skin.info("Generating...") - skin.status("Model", "llama3.2:latest") + skin = ReplSkin("shotcut", version="1.0.0") + skin.print_banner() # auto-detects repo-root or packaged SKILL.md + prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) + skin.success("Project saved") + skin.error("File not found") + skin.warning("Unsaved changes") + skin.info("Processing 24 clips...") + skin.status("Track 1", "3 clips, 00:02:30") skin.table(headers, rows) skin.print_goodbye() """ import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "ollama": "\033[38;5;255m", # white (Ollama branding) } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -98,23 +111,53 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: - software: Software name (e.g., "gimp", "shotcut", "ollama"). + software: Software name (e.g., "gimp", "shotcut", "blender"). version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -144,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -152,10 +197,28 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") - # Title: ◆ cli-anything · Ollama + # Title: ◆ cli-anything · Shotcut icon = self._c(_CYAN + _BOLD, "◆") brand = self._c(_CYAN + _BOLD, "cli-anything") dot = self._c(_DARK_GRAY, "·") @@ -166,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -496,5 +564,4 @@ _ANSI_256_TO_HEX = { "\033[38;5;80m": "#5fd7d7", # brand cyan "\033[38;5;208m": "#ff8700", # blender deep orange "\033[38;5;214m": "#ffaf00", # gimp warm orange - "\033[38;5;255m": "#eeeeee", # ollama white } diff --git a/ollama/agent-harness/cli_anything/ollama/utils/repl_skin.py b/ollama/agent-harness/cli_anything/ollama/utils/repl_skin.py index b356cb835..bc1fb6d1d 100644 --- a/ollama/agent-harness/cli_anything/ollama/utils/repl_skin.py +++ b/ollama/agent-harness/cli_anything/ollama/utils/repl_skin.py @@ -6,20 +6,21 @@ Copy this file into your CLI package at: Usage: from cli_anything..utils.repl_skin import ReplSkin - skin = ReplSkin("ollama", version="1.0.0") - skin.print_banner() - prompt_text = skin.prompt(project_name="llama3.2", modified=False) - skin.success("Model pulled") - skin.error("Connection failed") - skin.warning("No models loaded") - skin.info("Generating...") - skin.status("Model", "llama3.2:latest") + skin = ReplSkin("shotcut", version="1.0.0") + skin.print_banner() # auto-detects repo-root or packaged SKILL.md + prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) + skin.success("Project saved") + skin.error("File not found") + skin.warning("Unsaved changes") + skin.info("Processing 24 clips...") + skin.status("Track 1", "3 clips, 00:02:30") skin.table(headers, rows) skin.print_goodbye() """ import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "ollama": "\033[38;5;255m", # white (Ollama branding) } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -98,23 +111,53 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: - software: Software name (e.g., "gimp", "shotcut", "ollama"). + software: Software name (e.g., "gimp", "shotcut", "blender"). version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -144,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -152,10 +197,28 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") - # Title: ◆ cli-anything · Ollama + # Title: ◆ cli-anything · Shotcut icon = self._c(_CYAN + _BOLD, "◆") brand = self._c(_CYAN + _BOLD, "cli-anything") dot = self._c(_DARK_GRAY, "·") @@ -166,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -496,5 +564,4 @@ _ANSI_256_TO_HEX = { "\033[38;5;80m": "#5fd7d7", # brand cyan "\033[38;5;208m": "#ff8700", # blender deep orange "\033[38;5;214m": "#ffaf00", # gimp warm orange - "\033[38;5;255m": "#eeeeee", # ollama white } diff --git a/openclaw-skill/agent-harness/OPENCLAW.md b/openclaw-skill/agent-harness/OPENCLAW.md new file mode 100644 index 000000000..4cfddd711 --- /dev/null +++ b/openclaw-skill/agent-harness/OPENCLAW.md @@ -0,0 +1,185 @@ +# OpenClaw Macro System — Agent Harness SOP + +## What Is This? + +**OpenClaw Macro System** is a layered CLI that turns valuable GUI workflows into +parameterized, agent-callable macros. The agent sends one command: + +```bash +cli-anything-openclaw macro run export_png --param output=/tmp/out.png --json +``` + +The system handles everything else: parameter validation, precondition checks, +backend selection, step execution, postcondition verification, and structured +result output. The agent never touches the GUI directly. + +## Architecture + +``` +Agent + └─▶ cli-anything-openclaw macro run --param k=v --json (L6: CLI) + │ + MacroRuntime (L5) + │ 1. Validate params against MacroDefinition schema + │ 2. Check preconditions (file_exists, process_running, …) + │ 3. For each step: + │ RoutingEngine → select backend by priority (L3) + │ Backend.execute(step, resolved_params) (L2) + │ 4. Check postconditions + │ 5. Collect declared outputs + │ 6. Record telemetry in ExecutionSession + └─▶ { success, output, error, telemetry } +``` + +## Layer Mapping + +| Layer | Name | Implementation | +|-------|------|---------------| +| L7 | Agent Task Interface | Caller (OpenClaw or any agent) | +| L6 | Unified CLI Entry | `openclaw_cli.py` — Click CLI | +| L5 | Macro Execution Runtime | `core/runtime.py` | +| L4 | Parameterized Macro Model | `core/macro_model.py` + `macro_definitions/*.yaml` | +| L3 | Backend Routing Engine | `core/routing.py` | +| L2 | Execution Backends | `backends/` (5 backends) | +| L1 | Target Application | Any GUI-first or closed-source app | + +## Execution Backends + +| Backend | Priority | Trigger | Use case | +|---------|----------|---------|----------| +| `native_api` | 100 | `backend: native_api` | subprocess / shell commands | +| `gui_macro` | 80 | `backend: gui_macro` | precompiled coordinate replay (pyautogui) | +| `file_transform` | 70 | `backend: file_transform` | XML, JSON, text file editing | +| `semantic_ui` | 50 | `backend: semantic_ui` | accessibility API + keyboard (xdotool) | +| `recovery` | 10 | `backend: recovery` | retry + fallback orchestration | + +The RoutingEngine respects the step's explicit `backend:` field; if that backend +is unavailable it walks down the priority list. + +## Macro Definition Format + +Macros live in `cli_anything/openclaw/macro_definitions/` as YAML files: + +```yaml +name: export_png +version: "1.0" +description: Export the active diagram to PNG. + +parameters: + output: + type: string + required: true + example: /tmp/diagram.png + +preconditions: + - process_running: draw.io + - file_exists: /path/to/input.drawio + +steps: + - id: export + backend: native_api + action: run_command + params: + command: [draw.io, --export, --output, "${output}", input.drawio] + timeout_ms: 30000 + on_failure: fail # or: skip | continue + +postconditions: + - file_exists: ${output} + - file_size_gt: + - ${output} + - 100 + +outputs: + - name: exported_file + path: ${output} + +agent_hints: + danger_level: safe + side_effects: [creates_file] + reversible: true +``` + +### Supported Condition Types + +| Type | Args | Checks | +|------|------|--------| +| `file_exists` | path | `os.path.exists(path)` | +| `file_size_gt` | [path, min_bytes] | `os.stat(path).st_size > min_bytes` | +| `process_running` | name | `pgrep -x name` or psutil | +| `env_var` | name | `name in os.environ` | +| `always` | true/false | constant pass/fail | + +## Package Layout + +``` +openclaw-skill/ +└── agent-harness/ + ├── setup.py entry_point: cli-anything-openclaw + └── cli_anything/openclaw/ + ├── openclaw_cli.py Main Click CLI + ├── macro_definitions/ YAML macro registry + │ ├── manifest.yaml + │ └── examples/ + │ ├── export_file.yaml + │ ├── transform_json.yaml + │ └── undo_last.yaml + ├── core/ + │ ├── macro_model.py MacroDefinition + YAML loader + │ ├── registry.py MacroRegistry + │ ├── routing.py RoutingEngine + │ ├── runtime.py MacroRuntime (full lifecycle) + │ └── session.py ExecutionSession + telemetry + ├── backends/ + │ ├── base.py Backend ABC + StepResult + │ ├── native_api.py subprocess backend + │ ├── file_transform.py XML/JSON/text backend + │ ├── semantic_ui.py accessibility backend + │ ├── gui_macro.py compiled replay backend + │ └── recovery.py retry/fallback backend + ├── skills/SKILL.md Agent-readable skill definition + ├── utils/repl_skin.py Unified REPL skin (cli-anything standard) + └── tests/ + ├── test_core.py Unit tests (49 tests, no external deps) + └── test_full_e2e.py E2E + CLI subprocess tests (15 tests) +``` + +## Installation + +```bash +cd openclaw-skill/agent-harness +pip install -e . +``` + +**Runtime dependencies:** Python 3.10+, PyYAML, click, prompt-toolkit. + +**Optional (for specific backends):** +- `xdotool` — semantic_ui backend on Linux +- `pyautogui` — gui_macro backend +- `psutil` — richer process_running checks + +## Running Tests + +```bash +cd openclaw-skill/agent-harness +python3 -m pytest cli_anything/openclaw/tests/ -v -s +# 64 passed +``` + +## Key Design Decisions + +**Why YAML macros, not Python?** YAML macros are readable by agents without +running code, inspectable via `macro info`, and editable without touching the +harness source. + +**Why 5 backends?** Real GUI applications expose many different control +surfaces. The routing engine picks the most reliable one available — the agent +doesn't need to know which one ran. + +**Why preconditions and postconditions?** Agents operate in environments where +state is uncertain. Failing loudly before execution (preconditions) and +verifying after (postconditions) catches problems the agent can act on. + +**Why `on_failure: skip | continue`?** Some macro steps are best-effort (e.g., +confirming a dialog that may or may not appear). Skipping lets the macro +continue to the real work. diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/README.md b/openclaw-skill/agent-harness/cli_anything/openclaw/README.md new file mode 100644 index 000000000..195869bdb --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/README.md @@ -0,0 +1,75 @@ +# OpenClaw Macro System + +**OpenClaw Macro System** is a layered CLI that converts GUI workflows into +parameterized, agent-callable macros. Agents call `macro run ` through +a stable CLI; the system routes execution to the right backend (native plugin, +file transform, semantic UI, or compiled GUI replay) — invisible to the agent. + +## Installation + +```bash +pip install -e . +``` + +**Dependencies:** Python 3.10+, PyYAML, click, prompt-toolkit + +## Usage + +```bash +# List available macros +cli-anything-openclaw macro list --json + +# Inspect a macro +cli-anything-openclaw macro info export_file --json + +# Execute a macro +cli-anything-openclaw macro run transform_json \ + --param file=/tmp/config.json \ + --param key=theme --param value=dark --json + +# Dry run +cli-anything-openclaw --dry-run macro run export_file \ + --param output=/tmp/out.txt --json + +# Interactive REPL +cli-anything-openclaw +``` + +## Run Tests + +```bash +cd openclaw-skill/agent-harness +pip install -e ".[dev]" +python -m pytest cli_anything/openclaw/tests/ -v -s +``` + +## Architecture + +``` +cli-anything-openclaw (CLI) + └─▶ macro run --param key=value + │ + MacroRuntime + │ validate params + │ check preconditions + │ for each step: + │ RoutingEngine → select backend + │ Backend.execute(step, params) + │ check postconditions + └─▶ ExecutionResult { success, output, telemetry } +``` + +**Backends:** +- `native_api` — subprocess / shell commands +- `file_transform` — XML, JSON, text file editing +- `semantic_ui` — accessibility controls + keyboard shortcuts +- `gui_macro` — precompiled coordinate-based replay +- `recovery` — retry + fallback orchestration + +## Adding a Macro + +1. Create `cli_anything/openclaw/macro_definitions/my_macro.yaml` +2. Add it to `macro_definitions/manifest.yaml` +3. Verify: `cli-anything-openclaw macro validate my_macro --json` + +See `skills/SKILL.md` (installed with the package) for full macro YAML schema. diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/__init__.py b/openclaw-skill/agent-harness/cli_anything/openclaw/__init__.py new file mode 100644 index 000000000..58d9139ae --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/__init__.py @@ -0,0 +1 @@ +# cli_anything/openclaw package diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/__main__.py b/openclaw-skill/agent-harness/cli_anything/openclaw/__main__.py new file mode 100644 index 000000000..720ddd9e5 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/__main__.py @@ -0,0 +1,5 @@ +"""Enable: python3 -m cli_anything.openclaw""" +from cli_anything.openclaw.openclaw_cli import cli + +if __name__ == "__main__": + cli() diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/backends/__init__.py b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/backends/base.py b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/base.py new file mode 100644 index 000000000..1b22b2537 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/base.py @@ -0,0 +1,89 @@ +"""Backend base classes and result types. + +All execution backends inherit from Backend and return StepResult. +""" + +from __future__ import annotations + +import time +from abc import ABC, abstractmethod +from dataclasses import dataclass, field +from typing import Any, Optional + + +@dataclass +class StepResult: + """Result of a single macro step execution.""" + success: bool + output: dict = field(default_factory=dict) + error: str = "" + duration_ms: float = 0.0 + backend_used: str = "" + + def to_dict(self) -> dict: + return { + "success": self.success, + "output": self.output, + "error": self.error, + "duration_ms": self.duration_ms, + "backend_used": self.backend_used, + } + + +class BackendContext: + """Runtime context passed to each backend during step execution.""" + + def __init__( + self, + params: dict, + previous_results: Optional[list[StepResult]] = None, + dry_run: bool = False, + timeout_ms: int = 30_000, + ): + self.params = params + self.previous_results: list[StepResult] = previous_results or [] + self.dry_run = dry_run + self.timeout_ms = timeout_ms + self._start = time.time() + + def elapsed_ms(self) -> float: + return (time.time() - self._start) * 1000 + + +class Backend(ABC): + """Abstract base class for all execution backends. + + Concrete backends implement execute() and return a StepResult. + """ + + name: str = "base" + priority: int = 0 + + @abstractmethod + def execute( + self, + step: "MacroStep", # type: ignore[name-defined] + params: dict, + context: BackendContext, + ) -> StepResult: + """Execute a macro step. + + Args: + step: The MacroStep definition being executed. + params: Fully resolved (substituted) parameters. + context: Runtime context with previous results and flags. + + Returns: + StepResult describing success/failure and captured output. + """ + + def is_available(self) -> bool: + """Return True if this backend can be used in the current environment.""" + return True + + def describe(self) -> dict: + return { + "name": self.name, + "priority": self.priority, + "available": self.is_available(), + } diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/backends/file_transform.py b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/file_transform.py new file mode 100644 index 000000000..879110149 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/file_transform.py @@ -0,0 +1,203 @@ +"""FileTransformBackend — read, transform, and write project files. + +Supports XML (ElementTree), JSON, and plain text transformations. + +Example macro step: + + - backend: file_transform + action: json_set + params: + input_file: ${project_file} + output_file: ${project_file} + path: settings.grid_size + value: 20 + + - backend: file_transform + action: xml_set_attr + params: + input_file: diagram.drawio + output_file: diagram.drawio + xpath: .//mxCell[@id='1'] + attr: style + value: rounded=1; + + - backend: file_transform + action: text_replace + params: + input_file: config.ini + output_file: config.ini + find: "theme=default" + replace: "theme=dark" +""" + +from __future__ import annotations + +import json +import os +import time +from pathlib import Path + +from cli_anything.openclaw.backends.base import Backend, BackendContext, StepResult +from cli_anything.openclaw.core.macro_model import MacroStep, substitute + + +class FileTransformBackend(Backend): + """Transform project files without invoking the target application.""" + + name = "file_transform" + priority = 70 + + def execute(self, step: MacroStep, params: dict, context: BackendContext) -> StepResult: + t0 = time.time() + action = step.action + step_params = substitute(step.params, params) + + if context.dry_run: + return StepResult( + success=True, + output={"dry_run": True, "action": action}, + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + dispatch = { + "json_get": self._json_get, + "json_set": self._json_set, + "json_delete": self._json_delete, + "xml_set_attr": self._xml_set_attr, + "xml_get_attr": self._xml_get_attr, + "text_replace": self._text_replace, + "copy_file": self._copy_file, + } + + handler = dispatch.get(action) + if handler is None: + return StepResult( + success=False, + error=f"FileTransformBackend: unknown action '{action}'.", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + try: + output = handler(step_params) + return StepResult( + success=True, + output=output or {}, + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + except Exception as exc: + return StepResult( + success=False, + error=f"FileTransformBackend.{action}: {exc}", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + # ── JSON actions ───────────────────────────────────────────────────── + + def _json_get(self, p: dict) -> dict: + """Read a value from a JSON file by dot-path.""" + data = self._load_json(p["input_file"]) + val = self._dotpath_get(data, p["path"]) + return {"value": val, "path": p["path"]} + + def _json_set(self, p: dict) -> dict: + """Set a value in a JSON file by dot-path and write it back.""" + path = p.get("path", "") + value = p["value"] + data = self._load_json(p["input_file"]) if Path(p["input_file"]).is_file() else {} + self._dotpath_set(data, path, value) + self._save_json(p.get("output_file", p["input_file"]), data) + return {"path": path, "value": value} + + def _json_delete(self, p: dict) -> dict: + """Delete a key from a JSON file by dot-path.""" + data = self._load_json(p["input_file"]) + self._dotpath_delete(data, p["path"]) + self._save_json(p.get("output_file", p["input_file"]), data) + return {"deleted": p["path"]} + + # ── XML actions ────────────────────────────────────────────────────── + + def _xml_set_attr(self, p: dict) -> dict: + """Set an XML element attribute matched by XPath.""" + from xml.etree import ElementTree as ET + tree = ET.parse(p["input_file"]) + root = tree.getroot() + elements = root.findall(p["xpath"]) + if not elements: + raise ValueError(f"XPath matched nothing: {p['xpath']}") + for el in elements: + el.set(p["attr"], str(p["value"])) + tree.write(p.get("output_file", p["input_file"]), encoding="unicode", xml_declaration=True) + return {"matched": len(elements), "attr": p["attr"]} + + def _xml_get_attr(self, p: dict) -> dict: + """Get an XML element attribute matched by XPath.""" + from xml.etree import ElementTree as ET + tree = ET.parse(p["input_file"]) + root = tree.getroot() + elements = root.findall(p["xpath"]) + values = [el.get(p["attr"]) for el in elements] + return {"values": values, "attr": p["attr"]} + + # ── Text actions ───────────────────────────────────────────────────── + + def _text_replace(self, p: dict) -> dict: + """Simple find-and-replace in a text file.""" + content = Path(p["input_file"]).read_text(encoding="utf-8") + count = content.count(p["find"]) + content = content.replace(p["find"], p["replace"]) + out = p.get("output_file", p["input_file"]) + Path(out).write_text(content, encoding="utf-8") + return {"replacements": count} + + def _copy_file(self, p: dict) -> dict: + """Copy a file from src to dst.""" + import shutil + shutil.copy2(p["src"], p["dst"]) + size = os.path.getsize(p["dst"]) + return {"src": p["src"], "dst": p["dst"], "size": size} + + # ── Helpers ────────────────────────────────────────────────────────── + + def _load_json(self, path: str) -> dict: + with open(path, encoding="utf-8") as f: + return json.load(f) + + def _save_json(self, path: str, data: dict) -> None: + Path(path).parent.mkdir(parents=True, exist_ok=True) + with open(path, "w", encoding="utf-8") as f: + json.dump(data, f, indent=2, ensure_ascii=False) + + def _dotpath_get(self, data: dict, path: str): + keys = path.split(".") + cur = data + for k in keys: + if isinstance(cur, dict) and k in cur: + cur = cur[k] + else: + return None + return cur + + def _dotpath_set(self, data: dict, path: str, value) -> None: + keys = path.split(".") + cur = data + for k in keys[:-1]: + if k not in cur or not isinstance(cur[k], dict): + cur[k] = {} + cur = cur[k] + cur[keys[-1]] = value + + def _dotpath_delete(self, data: dict, path: str) -> None: + keys = path.split(".") + cur = data + for k in keys[:-1]: + if isinstance(cur, dict) and k in cur: + cur = cur[k] + else: + return + if isinstance(cur, dict) and keys[-1] in cur: + del cur[keys[-1]] diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/backends/gui_macro.py b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/gui_macro.py new file mode 100644 index 000000000..3dcbe9eca --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/gui_macro.py @@ -0,0 +1,205 @@ +"""GUIMacroBackend — replay precompiled coordinate-based macro sequences. + +A compiled macro is a JSON blob describing an exact sequence of mouse clicks, +key presses, and wait conditions. These are fast to execute but fragile to +layout changes. + +Compiled macro format (stored separately, referenced by step params): + + { + "version": 1, + "screen_resolution": "1920x1080", + "layout_hash": "abc123", + "steps": [ + {"type": "click", "x": 100, "y": 200, "button": "left", "delay_ms": 200}, + {"type": "key", "keys": "ctrl+s", "delay_ms": 100}, + {"type": "type", "text": "output.png", "delay_ms": 50}, + {"type": "wait_file", "path": "/tmp/out.png", "timeout_ms": 5000}, + {"type": "sleep", "ms": 500} + ] + } + +Example macro step: + + - backend: gui_macro + action: replay + params: + macro_file: macros/compiled/export_png.json + layout_strict: false # if true, fail when screen res changes +""" + +from __future__ import annotations + +import json +import time +from pathlib import Path + +from cli_anything.openclaw.backends.base import Backend, BackendContext, StepResult +from cli_anything.openclaw.core.macro_model import MacroStep, substitute + + +class GUIMacroBackend(Backend): + """Replay precompiled GUI automation sequences.""" + + name = "gui_macro" + priority = 80 + + def execute(self, step: MacroStep, params: dict, context: BackendContext) -> StepResult: + t0 = time.time() + action = step.action + step_params = substitute(step.params, params) + + if context.dry_run: + return StepResult( + success=True, + output={"dry_run": True, "action": action}, + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + if action != "replay": + return StepResult( + success=False, + error=f"GUIMacroBackend: unknown action '{action}'. Expected 'replay'.", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + return self._replay(step_params, context, t0) + + def is_available(self) -> bool: + """Available when at least one automation library is present.""" + for lib in ("pyautogui", "pynput"): + try: + __import__(lib) + return True + except ImportError: + pass + return False + + def _replay(self, p: dict, context: BackendContext, t0: float) -> StepResult: + """Load and replay a compiled macro file.""" + macro_file = p.get("macro_file", "") + if not macro_file: + return StepResult( + success=False, + error="GUIMacroBackend.replay: 'macro_file' param is required.", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + macro_path = Path(macro_file) + if not macro_path.is_file(): + return StepResult( + success=False, + error=f"GUIMacroBackend: compiled macro not found: {macro_file}", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + try: + with open(macro_path, encoding="utf-8") as f: + macro_blob = json.load(f) + except Exception as exc: + return StepResult( + success=False, + error=f"GUIMacroBackend: failed to load macro file: {exc}", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + layout_strict: bool = p.get("layout_strict", False) + if layout_strict: + check = self._check_layout(macro_blob) + if check: + return StepResult( + success=False, + error=f"GUIMacroBackend: layout mismatch — {check}", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + try: + steps_run = self._execute_steps(macro_blob.get("steps", []), context) + return StepResult( + success=True, + output={"steps_executed": steps_run, "macro_file": macro_file}, + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + except Exception as exc: + return StepResult( + success=False, + error=f"GUIMacroBackend.replay: {exc}", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + def _check_layout(self, macro_blob: dict) -> str: + """Return error string if current screen doesn't match expected.""" + expected_res = macro_blob.get("screen_resolution", "") + if not expected_res: + return "" + try: + import pyautogui + w, h = pyautogui.size() + current_res = f"{w}x{h}" + if current_res != expected_res: + return f"screen is {current_res}, macro expects {expected_res}" + except ImportError: + pass # Can't verify — allow through + return "" + + def _execute_steps(self, steps: list, context: BackendContext) -> int: + """Execute each step in the compiled macro.""" + try: + import pyautogui + has_pyautogui = True + except ImportError: + has_pyautogui = False + + count = 0 + for s in steps: + stype = s.get("type", "") + delay = s.get("delay_ms", 100) / 1000.0 + + if stype == "click": + if not has_pyautogui: + raise ImportError("pyautogui required for click steps. pip install pyautogui") + button = s.get("button", "left") + pyautogui.click(s["x"], s["y"], button=button) + + elif stype == "key": + if not has_pyautogui: + raise ImportError("pyautogui required for key steps. pip install pyautogui") + keys = s.get("keys", "").split("+") + if len(keys) == 1: + pyautogui.press(keys[0]) + else: + pyautogui.hotkey(*keys) + + elif stype == "type": + if not has_pyautogui: + raise ImportError("pyautogui required for type steps. pip install pyautogui") + pyautogui.typewrite(s.get("text", ""), interval=0.03) + + elif stype == "wait_file": + deadline = time.time() + s.get("timeout_ms", 5000) / 1000.0 + path = s.get("path", "") + while time.time() < deadline: + if Path(path).exists(): + break + time.sleep(0.1) + else: + raise TimeoutError(f"wait_file timed out: {path}") + delay = 0 # no additional delay after file wait + + elif stype == "sleep": + time.sleep(s.get("ms", 500) / 1000.0) + delay = 0 + + if delay > 0: + time.sleep(delay) + count += 1 + + return count diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/backends/native_api.py b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/native_api.py new file mode 100644 index 000000000..8cc2d5b20 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/native_api.py @@ -0,0 +1,167 @@ +"""NativeAPIBackend — executes macro steps via subprocess. + +Supports these action types (configured in macro step params): + + action: run_command + params: + command: [inkscape, --export-filename, /tmp/out.png, input.svg] + cwd: /optional/working/dir # optional + env: {KEY: value} # optional extra env vars + capture_stdout: true # store stdout in output.stdout + + action: find_executable + params: + name: inkscape + candidates: [inkscape, inkscape-1.0, /usr/bin/inkscape] + install_hint: "apt install inkscape" +""" + +from __future__ import annotations + +import os +import shutil +import subprocess +import time +from typing import Any + +from cli_anything.openclaw.backends.base import Backend, BackendContext, StepResult +from cli_anything.openclaw.core.macro_model import MacroStep, substitute + + +class NativeAPIBackend(Backend): + """Execute a macro step by running an external command.""" + + name = "native_api" + priority = 100 + + def execute(self, step: MacroStep, params: dict, context: BackendContext) -> StepResult: + t0 = time.time() + action = step.action + + if action == "find_executable": + return self._find_executable(step, params, context, t0) + elif action == "run_command": + return self._run_command(step, params, context, t0) + else: + return StepResult( + success=False, + error=f"NativeAPIBackend: unknown action '{action}'.", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + # ── Actions ────────────────────────────────────────────────────────── + + def _find_executable( + self, step: MacroStep, params: dict, context: BackendContext, t0: float + ) -> StepResult: + """Check that an executable exists; return its path.""" + step_params = substitute(step.params, params) + exe_name = step_params.get("name", "") + candidates: list[str] = step_params.get("candidates", [exe_name] if exe_name else []) + install_hint: str = step_params.get("install_hint", f"Install {exe_name}") + + for candidate in candidates: + found = shutil.which(candidate) + if found: + return StepResult( + success=True, + output={"executable": found, "name": candidate}, + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + return StepResult( + success=False, + error=( + f"Executable not found: {exe_name}. " + f"Tried: {candidates}. " + f"Install with: {install_hint}" + ), + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + def _run_command( + self, step: MacroStep, params: dict, context: BackendContext, t0: float + ) -> StepResult: + """Run an external command.""" + step_params = substitute(step.params, params) + command: list[str] = step_params.get("command", []) + if not command: + return StepResult( + success=False, + error="NativeAPIBackend.run_command: 'command' param is required.", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + if isinstance(command, str): + import shlex + command = shlex.split(command) + command = [str(c) for c in command] + + cwd: str = step_params.get("cwd", "") + extra_env: dict = step_params.get("env", {}) + capture_stdout: bool = step_params.get("capture_stdout", False) + + env = os.environ.copy() + if extra_env: + env.update({k: str(v) for k, v in extra_env.items()}) + + timeout_s = context.timeout_ms / 1000.0 + + if context.dry_run: + return StepResult( + success=True, + output={"dry_run": True, "command": command}, + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + try: + result = subprocess.run( + command, + capture_output=True, + text=True, + timeout=timeout_s, + cwd=cwd or None, + env=env, + ) + except FileNotFoundError as exc: + return StepResult( + success=False, + error=f"Command not found: {command[0]}. {exc}", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + except subprocess.TimeoutExpired: + return StepResult( + success=False, + error=f"Command timed out after {timeout_s:.0f}s: {command}", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + duration = (time.time() - t0) * 1000 + if result.returncode != 0: + return StepResult( + success=False, + error=( + f"Command failed (exit {result.returncode}): {command}\n" + f"stderr: {result.stderr.strip()}" + ), + output={"returncode": result.returncode, "stderr": result.stderr}, + backend_used=self.name, + duration_ms=duration, + ) + + output: dict[str, Any] = {"returncode": 0} + if capture_stdout: + output["stdout"] = result.stdout + return StepResult( + success=True, + output=output, + backend_used=self.name, + duration_ms=duration, + ) diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/backends/recovery.py b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/recovery.py new file mode 100644 index 000000000..8af918e48 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/recovery.py @@ -0,0 +1,128 @@ +"""RecoveryBackend — retry and fallback orchestration. + +This backend wraps another backend and retries failed steps with exponential +backoff. It can also fall back to an alternative backend on exhausted retries. + +Example macro step using recovery explicitly: + + - backend: recovery + action: retry_with_fallback + params: + primary_backend: native_api + fallback_backend: file_transform + max_retries: 3 + backoff_ms: [1000, 2000, 5000] + step: + action: run_command + params: + command: [inkscape, --export-filename, ${output}, input.svg] + +The MacroRuntime also uses the RecoveryBackend automatically when a step +specifies retry_max > 0 in the macro definition. +""" + +from __future__ import annotations + +import time + +from cli_anything.openclaw.backends.base import Backend, BackendContext, StepResult +from cli_anything.openclaw.core.macro_model import MacroStep, substitute + + +class RecoveryBackend(Backend): + """Retry and fallback orchestration backend.""" + + name = "recovery" + priority = 10 # lowest — last resort + + def __init__(self, backends: dict[str, "Backend"] | None = None): + """ + Args: + backends: Dict of backend_name -> Backend instance. + Injected by the RoutingEngine at runtime. + """ + self._backends = backends or {} + + def register_backend(self, backend: "Backend") -> None: + self._backends[backend.name] = backend + + def execute(self, step: MacroStep, params: dict, context: BackendContext) -> StepResult: + t0 = time.time() + action = step.action + + if action not in ("retry", "retry_with_fallback"): + return StepResult( + success=False, + error=f"RecoveryBackend: unknown action '{action}'. " + "Use 'retry' or 'retry_with_fallback'.", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + step_params = substitute(step.params, params) + inner_step_raw = step_params.get("step", {}) + if not inner_step_raw: + return StepResult( + success=False, + error="RecoveryBackend: 'step' param is required.", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + # Build an inner MacroStep from the nested definition + inner_step = MacroStep( + id=inner_step_raw.get("id", "recovery_inner"), + backend=step_params.get("primary_backend", inner_step_raw.get("backend", "native_api")), + action=inner_step_raw.get("action", ""), + params=inner_step_raw.get("params", {}), + timeout_ms=context.timeout_ms, + ) + + max_retries: int = int(step_params.get("max_retries", step.retry_max or 2)) + backoff_ms: list[int] = step_params.get("backoff_ms", [1000, 2000, 5000]) + fallback_name: str = step_params.get("fallback_backend", "") + + last_result = None + for attempt in range(max_retries + 1): + backend = self._backends.get(inner_step.backend) + if backend is None: + return StepResult( + success=False, + error=f"RecoveryBackend: backend '{inner_step.backend}' not registered.", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + last_result = backend.execute(inner_step, params, context) + if last_result.success: + last_result.backend_used = f"{self.name}({inner_step.backend}, attempt={attempt + 1})" + return last_result + + # Failed — decide whether to retry or fall back + if attempt < max_retries: + wait = backoff_ms[min(attempt, len(backoff_ms) - 1)] / 1000.0 + time.sleep(wait) + elif fallback_name and fallback_name in self._backends: + # Switch to fallback backend for one final attempt + inner_step = MacroStep( + id=inner_step.id, + backend=fallback_name, + action=inner_step.action, + params=inner_step.params, + timeout_ms=inner_step.timeout_ms, + ) + fallback_result = self._backends[fallback_name].execute(inner_step, params, context) + if fallback_result.success: + fallback_result.backend_used = f"{self.name}(fallback={fallback_name})" + return fallback_result + last_result = fallback_result + + if last_result is None: + last_result = StepResult( + success=False, + error="RecoveryBackend: no attempts made.", + backend_used=self.name, + ) + last_result.duration_ms = (time.time() - t0) * 1000 + last_result.backend_used = self.name + return last_result diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/backends/semantic_ui.py b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/semantic_ui.py new file mode 100644 index 000000000..46ff8bbe6 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/backends/semantic_ui.py @@ -0,0 +1,202 @@ +"""SemanticUIBackend — drive applications via accessibility and keyboard shortcuts. + +This backend provides stubs for AT-SPI (Linux), Windows UIA, and macOS +accessibility APIs. Full implementations require platform-specific libraries +(pyatspi2, pywinauto, pyobjc-framework-Accessibility). + +Example macro step: + + - backend: semantic_ui + action: menu_click + params: + menu_path: [File, Export As, PNG] + + - backend: semantic_ui + action: shortcut + params: + keys: ctrl+shift+e + + - backend: semantic_ui + action: wait_for_window + params: + title_contains: Export + timeout_ms: 5000 +""" + +from __future__ import annotations + +import platform +import time + +from cli_anything.openclaw.backends.base import Backend, BackendContext, StepResult +from cli_anything.openclaw.core.macro_model import MacroStep, substitute + + +class SemanticUIBackend(Backend): + """Drive applications through semantic (accessibility) controls.""" + + name = "semantic_ui" + priority = 50 + + def execute(self, step: MacroStep, params: dict, context: BackendContext) -> StepResult: + t0 = time.time() + action = step.action + step_params = substitute(step.params, params) + + if context.dry_run: + return StepResult( + success=True, + output={"dry_run": True, "action": action}, + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + dispatch = { + "shortcut": self._shortcut, + "menu_click": self._menu_click, + "wait_for_window": self._wait_for_window, + "button_click": self._button_click, + "type_text": self._type_text, + } + + handler = dispatch.get(action) + if handler is None: + return StepResult( + success=False, + error=f"SemanticUIBackend: unknown action '{action}'.", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + try: + output = handler(step_params) + return StepResult( + success=True, + output=output or {}, + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + except NotImplementedError as exc: + return StepResult( + success=False, + error=str(exc), + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + except Exception as exc: + return StepResult( + success=False, + error=f"SemanticUIBackend.{action}: {exc}", + backend_used=self.name, + duration_ms=(time.time() - t0) * 1000, + ) + + def is_available(self) -> bool: + # Available when at least one accessibility library can be found + if platform.system() == "Linux": + try: + import pyatspi # noqa: F401 + return True + except ImportError: + pass + elif platform.system() == "Windows": + try: + import pywinauto # noqa: F401 + return True + except ImportError: + pass + elif platform.system() == "Darwin": + try: + import ApplicationServices # noqa: F401 + return True + except ImportError: + pass + return False + + # ── Actions ────────────────────────────────────────────────────────── + + def _shortcut(self, p: dict) -> dict: + """Send a keyboard shortcut to the focused window.""" + keys: str = p.get("keys", "") + if not keys: + raise ValueError("shortcut action requires 'keys' param.") + + sys = platform.system() + if sys == "Linux": + return self._shortcut_xdotool(keys) + elif sys == "Windows": + return self._shortcut_win32(keys) + elif sys == "Darwin": + return self._shortcut_macos(keys) + raise NotImplementedError( + f"SemanticUIBackend.shortcut: not yet implemented for platform {sys}. " + "Consider using native_api backend instead." + ) + + def _shortcut_xdotool(self, keys: str) -> dict: + """Use xdotool to send keys on Linux.""" + import shutil + if not shutil.which("xdotool"): + raise NotImplementedError( + "xdotool not found. Install with: apt install xdotool" + ) + import subprocess + # Convert from ctrl+shift+e → ctrl+shift+e (xdotool format) + xdg_keys = keys.replace("+", " ") + subprocess.run(["xdotool", "key", xdg_keys], check=True) + return {"keys": keys, "method": "xdotool"} + + def _shortcut_win32(self, keys: str) -> dict: + raise NotImplementedError( + "SemanticUIBackend.shortcut: Windows requires pywinauto. " + "pip install pywinauto" + ) + + def _shortcut_macos(self, keys: str) -> dict: + raise NotImplementedError( + "SemanticUIBackend.shortcut: macOS requires pyobjc. " + "pip install pyobjc-framework-Quartz" + ) + + def _menu_click(self, p: dict) -> dict: + """Click a menu item by path.""" + menu_path: list = p.get("menu_path", []) + raise NotImplementedError( + f"SemanticUIBackend.menu_click: not yet implemented. " + f"Menu path: {menu_path}. " + "Use native_api or file_transform backends instead when possible." + ) + + def _wait_for_window(self, p: dict) -> dict: + """Wait for a window matching title criteria.""" + title_contains: str = p.get("title_contains", "") + timeout_ms: int = int(p.get("timeout_ms", 5000)) + raise NotImplementedError( + f"SemanticUIBackend.wait_for_window: not yet implemented. " + f"Looking for: '{title_contains}'. " + "Consider using postconditions (file_exists) to detect completion." + ) + + def _button_click(self, p: dict) -> dict: + """Click a UI button by label.""" + raise NotImplementedError( + f"SemanticUIBackend.button_click: not yet implemented. " + "Use native_api or file_transform backends instead when possible." + ) + + def _type_text(self, p: dict) -> dict: + """Type text into the focused input field.""" + text: str = p.get("text", "") + if not text: + raise ValueError("type_text action requires 'text' param.") + sys = platform.system() + if sys == "Linux": + import shutil + if not shutil.which("xdotool"): + raise NotImplementedError("xdotool not found. apt install xdotool") + import subprocess + subprocess.run(["xdotool", "type", "--clearmodifiers", text], check=True) + return {"text": text, "method": "xdotool"} + raise NotImplementedError( + f"SemanticUIBackend.type_text: not yet implemented for {sys}." + ) diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/core/__init__.py b/openclaw-skill/agent-harness/cli_anything/openclaw/core/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/core/macro_model.py b/openclaw-skill/agent-harness/cli_anything/openclaw/core/macro_model.py new file mode 100644 index 000000000..b9b2a6edf --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/core/macro_model.py @@ -0,0 +1,342 @@ +"""Macro data model — parse and validate YAML macro definitions. + +A macro definition file (YAML) describes a reusable, parameterized workflow +that the MacroRuntime can execute against any backend. + +Example (minimal): + + name: export_file + version: "1.0" + description: Export a file using the target app's CLI. + + parameters: + output: + type: string + required: true + example: /tmp/out.png + + steps: + - backend: native_api + action: run_command + params: + command: [echo, "exported", "${output}"] + + postconditions: + - file_exists: ${output} +""" + +from __future__ import annotations + +import re +from dataclasses import dataclass, field +from pathlib import Path +from typing import Any, Optional + +try: + import yaml +except ImportError as e: + raise ImportError("PyYAML is required: pip install PyYAML") from e + + +# ── Dataclasses ────────────────────────────────────────────────────────────── + +@dataclass +class MacroParameter: + name: str + type: str = "string" # string | integer | boolean | list | dict + required: bool = False + default: Any = None + description: str = "" + example: Any = None + enum: Optional[list] = None + min: Optional[float] = None + max: Optional[float] = None + + def validate_value(self, value: Any) -> list[str]: + """Return list of validation error strings (empty if valid).""" + errors: list[str] = [] + if value is None: + if self.required: + errors.append(f"Parameter '{self.name}' is required.") + return errors + + if self.type == "integer": + if not isinstance(value, int): + try: + value = int(value) + except (ValueError, TypeError): + errors.append(f"Parameter '{self.name}' must be an integer.") + return errors + if self.min is not None and value < self.min: + errors.append(f"Parameter '{self.name}' must be >= {self.min}.") + if self.max is not None and value > self.max: + errors.append(f"Parameter '{self.name}' must be <= {self.max}.") + + if self.enum and value not in self.enum: + errors.append( + f"Parameter '{self.name}' must be one of {self.enum}, got {value!r}." + ) + return errors + + +@dataclass +class MacroStep: + backend: str # native_api | file_transform | semantic_ui | gui_macro | recovery + action: str # backend-specific action name + id: str = "" + params: dict = field(default_factory=dict) + timeout_ms: int = 30_000 + on_failure: str = "fail" # fail | skip | continue + retry_max: int = 0 + retry_backoff_ms: list[int] = field(default_factory=lambda: [1000]) + + def to_dict(self) -> dict: + return { + "id": self.id, + "backend": self.backend, + "action": self.action, + "params": self.params, + "timeout_ms": self.timeout_ms, + "on_failure": self.on_failure, + "retry_max": self.retry_max, + "retry_backoff_ms": self.retry_backoff_ms, + } + + +@dataclass +class MacroCondition: + """A single pre- or post-condition check. + + Supported types (derived from the YAML key): + file_exists: + file_size_gt: [, ] + process_running: + env_var: + always: true | false + """ + type: str + args: Any # depends on type + + def to_dict(self) -> dict: + return {"type": self.type, "args": self.args} + + @classmethod + def from_dict(cls, d: dict) -> "MacroCondition": + """Parse a condition dict like {file_exists: /tmp/out.png}.""" + if not isinstance(d, dict) or len(d) != 1: + raise ValueError(f"Condition must be a single-key dict, got: {d!r}") + ctype, args = next(iter(d.items())) + return cls(type=ctype, args=args) + + +@dataclass +class MacroOutput: + name: str + description: str = "" + path: Optional[str] = None # raw template string (may contain ${...}) + value: Optional[Any] = None + + def to_dict(self) -> dict: + return { + "name": self.name, + "description": self.description, + "path": self.path, + "value": self.value, + } + + +@dataclass +class MacroDefinition: + name: str + version: str = "1.0" + description: str = "" + parameters: dict[str, MacroParameter] = field(default_factory=dict) + preconditions: list[MacroCondition] = field(default_factory=list) + steps: list[MacroStep] = field(default_factory=list) + postconditions: list[MacroCondition] = field(default_factory=list) + outputs: list[MacroOutput] = field(default_factory=list) + tags: list[str] = field(default_factory=list) + composable: bool = False + agent_hints: dict = field(default_factory=dict) + source_path: str = "" # absolute path to the .yaml file + + # ── Validation ──────────────────────────────────────────────────── + + def validate(self) -> list[str]: + """Structural validation — returns list of error strings.""" + errors: list[str] = [] + if not self.name: + errors.append("Macro name is required.") + if not self.steps: + errors.append(f"Macro '{self.name}' has no steps.") + valid_backends = {"native_api", "file_transform", "semantic_ui", "gui_macro", "recovery"} + for i, step in enumerate(self.steps): + if step.backend not in valid_backends: + errors.append( + f"Step {i} has unknown backend '{step.backend}'. " + f"Valid: {sorted(valid_backends)}" + ) + if not step.action: + errors.append(f"Step {i} (backend={step.backend}) is missing 'action'.") + for pname, pspec in self.parameters.items(): + if pspec.type not in ("string", "integer", "boolean", "list", "dict", "float"): + errors.append(f"Parameter '{pname}' has unknown type '{pspec.type}'.") + return errors + + def validate_params(self, params: dict) -> list[str]: + """Validate runtime parameter values against schema.""" + errors: list[str] = [] + for pname, pspec in self.parameters.items(): + value = params.get(pname, pspec.default) + errors.extend(pspec.validate_value(value)) + return errors + + def resolve_params(self, params: dict) -> dict: + """Return params with defaults filled in.""" + resolved = {} + for pname, pspec in self.parameters.items(): + resolved[pname] = params.get(pname, pspec.default) + # Pass through any extra params not in schema + for k, v in params.items(): + if k not in resolved: + resolved[k] = v + return resolved + + # ── Serialisation ───────────────────────────────────────────────── + + def to_dict(self) -> dict: + return { + "name": self.name, + "version": self.version, + "description": self.description, + "parameters": { + n: { + "type": p.type, + "required": p.required, + "default": p.default, + "description": p.description, + "example": p.example, + "enum": p.enum, + } + for n, p in self.parameters.items() + }, + "preconditions": [c.to_dict() for c in self.preconditions], + "steps": [s.to_dict() for s in self.steps], + "postconditions": [c.to_dict() for c in self.postconditions], + "outputs": [o.to_dict() for o in self.outputs], + "tags": self.tags, + "composable": self.composable, + "agent_hints": self.agent_hints, + "source_path": self.source_path, + } + + +# ── Substitution ───────────────────────────────────────────────────────────── + +_SUBST_RE = re.compile(r"\$\{([^}]+)\}") + + +def substitute(template: Any, params: dict) -> Any: + """Replace ${key} placeholders in strings (and nested structures). + + Works recursively on strings, lists, and dicts. + Leaves non-string types (int, bool, None) untouched. + """ + if isinstance(template, str): + def _replace(m: re.Match) -> str: + key = m.group(1).strip() + val = params.get(key) + return str(val) if val is not None else m.group(0) + return _SUBST_RE.sub(_replace, template) + if isinstance(template, list): + return [substitute(item, params) for item in template] + if isinstance(template, dict): + return {k: substitute(v, params) for k, v in template.items()} + return template + + +# ── YAML loader ─────────────────────────────────────────────────────────────── + +def _parse_parameter(name: str, raw: dict) -> MacroParameter: + return MacroParameter( + name=name, + type=raw.get("type", "string"), + required=raw.get("required", False), + default=raw.get("default"), + description=raw.get("description", ""), + example=raw.get("example"), + enum=raw.get("enum"), + min=raw.get("min"), + max=raw.get("max"), + ) + + +def _parse_step(i: int, raw: dict) -> MacroStep: + retry = raw.get("retry_policy", {}) or {} + return MacroStep( + id=raw.get("id", f"step_{i}"), + backend=raw.get("backend", "native_api"), + action=raw.get("action", ""), + params=raw.get("params", {}), + timeout_ms=int(raw.get("timeout_ms", raw.get("timeout", "30s") + .replace("s", "000") if isinstance(raw.get("timeout"), str) + else raw.get("timeout_ms", 30_000))), + on_failure=raw.get("on_failure", "fail"), + retry_max=retry.get("max_retries", raw.get("retry_max", 0)), + retry_backoff_ms=retry.get("backoff_ms", [1000]), + ) + + +def _parse_condition(raw: Any) -> MacroCondition: + if isinstance(raw, dict): + return MacroCondition.from_dict(raw) + raise ValueError(f"Cannot parse condition from {raw!r}") + + +def _parse_output(raw: dict) -> MacroOutput: + return MacroOutput( + name=raw.get("name", ""), + description=raw.get("description", ""), + path=raw.get("path"), + value=raw.get("value"), + ) + + +def load_from_yaml(path: str) -> MacroDefinition: + """Load and parse a macro definition from a YAML file.""" + p = Path(path) + if not p.is_file(): + raise FileNotFoundError(f"Macro file not found: {path}") + with open(p, encoding="utf-8") as f: + raw = yaml.safe_load(f) + if not isinstance(raw, dict): + raise ValueError(f"Macro YAML must be a mapping, got {type(raw).__name__}: {path}") + + parameters: dict[str, MacroParameter] = {} + for pname, praw in (raw.get("parameters") or {}).items(): + if isinstance(praw, dict): + parameters[pname] = _parse_parameter(pname, praw) + else: + # shorthand: parameter_name: string + parameters[pname] = MacroParameter(name=pname, type=str(praw)) + + steps = [_parse_step(i, s) for i, s in enumerate(raw.get("steps") or [])] + preconditions = [_parse_condition(c) for c in (raw.get("preconditions") or [])] + postconditions = [_parse_condition(c) for c in (raw.get("postconditions") or [])] + outputs = [_parse_output(o) for o in (raw.get("outputs") or [])] + + macro = MacroDefinition( + name=raw.get("name", p.stem), + version=str(raw.get("version", "1.0")), + description=raw.get("description", ""), + parameters=parameters, + preconditions=preconditions, + steps=steps, + postconditions=postconditions, + outputs=outputs, + tags=raw.get("tags", []), + composable=raw.get("composable", False), + agent_hints=raw.get("agent_hints", {}), + source_path=str(p.resolve()), + ) + return macro diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/core/registry.py b/openclaw-skill/agent-harness/cli_anything/openclaw/core/registry.py new file mode 100644 index 000000000..8735af349 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/core/registry.py @@ -0,0 +1,164 @@ +"""MacroRegistry — discovers and loads macro definitions from a directory. + +The registry scans a macros/ directory (and subdirectories) for *.yaml files, +optionally guided by a manifest.yaml index. + +Usage: + from cli_anything.openclaw.core.registry import MacroRegistry + registry = MacroRegistry("/path/to/macros") + macro = registry.load("export_file") + all_macros = registry.list_all() +""" + +from __future__ import annotations + +import os +from pathlib import Path +from typing import Optional + +try: + import yaml +except ImportError as e: + raise ImportError("PyYAML is required: pip install PyYAML") from e + +from cli_anything.openclaw.core.macro_model import MacroDefinition, load_from_yaml + + +class MacroRegistry: + """Discovers and caches macro definitions from a macros/ directory.""" + + def __init__(self, macros_dir: Optional[str] = None): + """ + Args: + macros_dir: Path to the directory containing macro YAML files. + Defaults to the macros/ directory bundled with the package. + """ + if macros_dir is None: + macros_dir = str(Path(__file__).resolve().parent.parent / "macro_definitions") + self.macros_dir = Path(macros_dir) + self._cache: dict[str, MacroDefinition] = {} + self._scanned = False + + # ── Internal scan ──────────────────────────────────────────────────── + + def _scan(self) -> None: + """Scan macros_dir and populate the cache.""" + if self._scanned: + return + + if not self.macros_dir.is_dir(): + self._scanned = True + return + + # Try manifest.yaml first (explicit ordered index) + manifest_path = self.macros_dir / "manifest.yaml" + if manifest_path.is_file(): + self._load_from_manifest(manifest_path) + else: + # Fallback: scan all *.yaml files recursively (except manifest.yaml) + for yaml_path in sorted(self.macros_dir.rglob("*.yaml")): + if yaml_path.name == "manifest.yaml": + continue + self._load_file(yaml_path) + + self._scanned = True + + def _load_from_manifest(self, manifest_path: Path) -> None: + """Load macros listed in manifest.yaml.""" + with open(manifest_path, encoding="utf-8") as f: + manifest = yaml.safe_load(f) or {} + + macros_list = manifest.get("macros", []) + for entry in macros_list: + if isinstance(entry, dict): + rel_path = entry.get("path") + else: + rel_path = str(entry) + if not rel_path: + continue + yaml_path = self.macros_dir / rel_path + if yaml_path.is_file(): + self._load_file(yaml_path) + + # Also scan for any yaml files NOT in the manifest (permissive) + listed_names = {m.name for m in self._cache.values()} + for yaml_path in sorted(self.macros_dir.rglob("*.yaml")): + if yaml_path.name == "manifest.yaml": + continue + try: + # Quick peek to get the name without full parse + with open(yaml_path, encoding="utf-8") as f: + raw = yaml.safe_load(f) or {} + name = raw.get("name", yaml_path.stem) + if name not in listed_names: + self._load_file(yaml_path) + except Exception: + pass + + def _load_file(self, yaml_path: Path) -> Optional[MacroDefinition]: + """Parse one yaml file and cache the result.""" + try: + macro = load_from_yaml(str(yaml_path)) + self._cache[macro.name] = macro + return macro + except Exception as exc: + # Log but don't crash — bad macros should not block the registry + import sys + print(f"[registry] Warning: failed to load {yaml_path}: {exc}", file=sys.stderr) + return None + + # ── Public API ─────────────────────────────────────────────────────── + + def load(self, name: str) -> MacroDefinition: + """Load a macro by name. + + Raises: + KeyError: if the macro is not found. + """ + self._scan() + if name not in self._cache: + available = sorted(self._cache.keys()) + raise KeyError( + f"Macro '{name}' not found. Available: {available}" + ) + return self._cache[name] + + def list_all(self) -> list[MacroDefinition]: + """Return all loaded macro definitions, sorted by name.""" + self._scan() + return sorted(self._cache.values(), key=lambda m: m.name) + + def list_names(self) -> list[str]: + """Return all macro names, sorted.""" + self._scan() + return sorted(self._cache.keys()) + + def reload(self, name: Optional[str] = None) -> None: + """Force reload from disk. + + Args: + name: If given, reload just that macro file. + If None, rescan the entire directory. + """ + if name is None: + self._cache.clear() + self._scanned = False + self._scan() + elif name in self._cache: + path = self._cache[name].source_path + if path and Path(path).is_file(): + self._load_file(Path(path)) + + def register(self, macro: MacroDefinition) -> None: + """Programmatically register a macro (e.g. from tests).""" + self._cache[macro.name] = macro + self._scanned = True # Don't re-scan over in-memory registrations + + def info(self) -> dict: + """Return registry metadata.""" + self._scan() + return { + "macros_dir": str(self.macros_dir), + "total": len(self._cache), + "names": self.list_names(), + } diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/core/routing.py b/openclaw-skill/agent-harness/cli_anything/openclaw/core/routing.py new file mode 100644 index 000000000..ccac3b0ce --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/core/routing.py @@ -0,0 +1,113 @@ +"""RoutingEngine — select the best backend for each macro step. + +Priority order (higher = preferred): + native_api 100 + gui_macro 80 + file_transform 70 + semantic_ui 50 + recovery 10 (only via explicit backend: recovery, or auto-retry) + +The router respects the step's explicit `backend:` field. +It then checks availability; if the primary is unavailable it walks down +the priority list. +""" + +from __future__ import annotations + +from cli_anything.openclaw.backends.base import Backend, BackendContext, StepResult +from cli_anything.openclaw.backends.native_api import NativeAPIBackend +from cli_anything.openclaw.backends.file_transform import FileTransformBackend +from cli_anything.openclaw.backends.semantic_ui import SemanticUIBackend +from cli_anything.openclaw.backends.gui_macro import GUIMacroBackend +from cli_anything.openclaw.backends.recovery import RecoveryBackend +from cli_anything.openclaw.core.macro_model import MacroStep + + +_BACKEND_PRIORITY: dict[str, int] = { + "native_api": 100, + "gui_macro": 80, + "file_transform": 70, + "semantic_ui": 50, + "recovery": 10, +} + + +class RoutingEngine: + """Selects and manages execution backends for macro steps.""" + + def __init__(self): + self._recovery = RecoveryBackend() + self._backends: dict[str, Backend] = { + "native_api": NativeAPIBackend(), + "file_transform": FileTransformBackend(), + "semantic_ui": SemanticUIBackend(), + "gui_macro": GUIMacroBackend(), + "recovery": self._recovery, + } + # Wire recovery with all other backends so it can delegate + for b in self._backends.values(): + self._recovery.register_backend(b) + + def select(self, step: MacroStep) -> Backend: + """Return the best available backend for the given step. + + Respects step.backend if set; falls back down the priority list + if that backend is unavailable. + + Raises: + RuntimeError: if no backend is available. + """ + requested = step.backend + # Try the requested backend first + if requested in self._backends: + b = self._backends[requested] + if b.is_available(): + return b + + # Walk by priority (descending) for a fallback + for name in sorted(_BACKEND_PRIORITY, key=lambda k: -_BACKEND_PRIORITY[k]): + if name == "recovery": + continue # Never auto-fall-through to recovery + b = self._backends.get(name) + if b and b.is_available(): + return b + + raise RuntimeError( + f"No backend available for step '{step.id}' " + f"(requested: '{requested}'). " + "Check that required tools are installed." + ) + + def execute_step( + self, + step: MacroStep, + params: dict, + context: BackendContext, + ) -> StepResult: + """Route and execute a step, applying retry logic if configured.""" + backend = self.select(step) + + if step.retry_max <= 0: + return backend.execute(step, params, context) + + # Retry with backoff + last_result: StepResult | None = None + backoff = step.retry_backoff_ms or [1000] + for attempt in range(step.retry_max + 1): + last_result = backend.execute(step, params, context) + if last_result.success: + return last_result + if attempt < step.retry_max: + import time + wait = backoff[min(attempt, len(backoff) - 1)] / 1000.0 + time.sleep(wait) + + assert last_result is not None + return last_result + + def describe(self) -> dict: + """Return a description of all registered backends and their status.""" + return { + name: b.describe() + for name, b in self._backends.items() + } diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/core/runtime.py b/openclaw-skill/agent-harness/cli_anything/openclaw/core/runtime.py new file mode 100644 index 000000000..fb76a9ba7 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/core/runtime.py @@ -0,0 +1,306 @@ +"""MacroRuntime — orchestrates the full macro execution lifecycle. + +Lifecycle for execute(macro_name, params): + + 1. Load macro definition from registry + 2. Resolve + validate parameters (fill defaults, type-check) + 3. Check preconditions + 4. For each step: + a. substitute ${params} into step.params + b. route to backend + c. execute (with retry if configured) + d. handle on_failure = fail | skip | continue + 5. Check postconditions + 6. Collect declared outputs + 7. Record telemetry in session + 8. Return ExecutionResult +""" + +from __future__ import annotations + +import os +import time +from dataclasses import dataclass, field +from typing import Any, Optional + +from cli_anything.openclaw.core.macro_model import ( + MacroCondition, + MacroDefinition, + MacroStep, + substitute, +) +from cli_anything.openclaw.core.registry import MacroRegistry +from cli_anything.openclaw.core.routing import RoutingEngine +from cli_anything.openclaw.core.session import ExecutionSession, RunRecord +from cli_anything.openclaw.backends.base import BackendContext, StepResult + + +# ── Result types ───────────────────────────────────────────────────────────── + +@dataclass +class ExecutionResult: + success: bool + macro_name: str + output: dict = field(default_factory=dict) + error: str = "" + step_results: list[StepResult] = field(default_factory=list) + telemetry: dict = field(default_factory=dict) + + def to_dict(self) -> dict: + return { + "success": self.success, + "macro_name": self.macro_name, + "output": self.output, + "error": self.error, + "telemetry": self.telemetry, + "steps": [s.to_dict() for s in self.step_results], + } + + +# ── Condition checker ──────────────────────────────────────────────────────── + +def _check_condition(cond: MacroCondition, resolved_params: dict) -> Optional[str]: + """Evaluate one condition. + + Returns None if the condition passes, or an error string if it fails. + """ + ctype = cond.type + args = substitute(cond.args, resolved_params) + + if ctype == "file_exists": + path = str(args) + if not os.path.exists(path): + return f"file_exists: '{path}' not found." + return None + + elif ctype == "file_size_gt": + if not isinstance(args, (list, tuple)) or len(args) < 2: + return f"file_size_gt: expected [path, min_bytes], got {args!r}" + path, min_bytes = str(args[0]), int(args[1]) + if not os.path.exists(path): + return f"file_size_gt: '{path}' not found." + size = os.path.getsize(path) + if size <= min_bytes: + return f"file_size_gt: '{path}' is {size} bytes, expected > {min_bytes}." + return None + + elif ctype == "process_running": + name = str(args) + # Try pgrep first, then psutil + import shutil + import subprocess + if shutil.which("pgrep"): + r = subprocess.run(["pgrep", "-x", name], capture_output=True) + if r.returncode == 0: + return None + return f"process_running: '{name}' not found (pgrep)." + try: + import psutil + for proc in psutil.process_iter(["name"]): + if proc.info["name"] == name: + return None + return f"process_running: '{name}' not found." + except ImportError: + # Can't verify — let it pass with a warning + return None + + elif ctype == "env_var": + name = str(args) + if name not in os.environ: + return f"env_var: '{name}' is not set in the environment." + return None + + elif ctype == "always": + if str(args).lower() in ("false", "0", "no"): + return "always: false condition." + return None + + else: + # Unknown condition type — warn but don't block + return None + + +# ── Runtime ────────────────────────────────────────────────────────────────── + +class MacroRuntime: + """Executes macros end-to-end.""" + + def __init__( + self, + registry: Optional[MacroRegistry] = None, + routing_engine: Optional[RoutingEngine] = None, + session: Optional[ExecutionSession] = None, + ): + self.registry = registry or MacroRegistry() + self.routing = routing_engine or RoutingEngine() + self.session = session or ExecutionSession() + + # ── Public API ─────────────────────────────────────────────────────── + + def execute( + self, + macro_name: str, + params: dict, + dry_run: bool = False, + ) -> ExecutionResult: + """Execute a macro by name with the given parameters. + + Args: + macro_name: Name of the macro to execute. + params: Input parameters (raw, may be strings from CLI). + dry_run: If True, skip all side effects and return simulated success. + + Returns: + ExecutionResult with success status, outputs, and telemetry. + """ + t0 = time.time() + + # 1. Load macro + try: + macro = self.registry.load(macro_name) + except KeyError as exc: + return ExecutionResult( + success=False, macro_name=macro_name, error=str(exc) + ) + + # 2. Resolve + validate params + resolved = macro.resolve_params(params) + param_errors = macro.validate_params(resolved) + if param_errors: + return ExecutionResult( + success=False, + macro_name=macro_name, + error="Parameter validation failed:\n" + "\n".join(f" - {e}" for e in param_errors), + ) + + # 3. Check preconditions + precond_errors = self.check_conditions(macro.preconditions, resolved) + if precond_errors: + return ExecutionResult( + success=False, + macro_name=macro_name, + error="Preconditions not met:\n" + "\n".join(f" - {e}" for e in precond_errors), + ) + + # 4. Execute steps + step_results: list[StepResult] = [] + context = BackendContext( + params=resolved, + previous_results=step_results, + dry_run=dry_run, + ) + + aborted = False + abort_error = "" + for step in macro.steps: + context.timeout_ms = step.timeout_ms + try: + result = self.routing.execute_step(step, resolved, context) + except Exception as exc: + result = StepResult( + success=False, + error=f"Unhandled exception in step '{step.id}': {exc}", + backend_used=step.backend, + ) + + step_results.append(result) + + if not result.success: + if step.on_failure == "fail": + aborted = True + abort_error = f"Step '{step.id}' failed: {result.error}" + break + elif step.on_failure == "skip": + continue + # on_failure == "continue" — keep going regardless + + # 5. Check postconditions (skip if already failed) + postcond_errors: list[str] = [] + if not aborted: + postcond_errors = self.check_conditions(macro.postconditions, resolved) + + success = not aborted and not postcond_errors + + # 6. Collect outputs + output = self._collect_outputs(macro, resolved, step_results) if success else {} + + # 7. Build error string + error = "" + if aborted: + error = abort_error + elif postcond_errors: + error = "Postconditions failed:\n" + "\n".join(f" - {e}" for e in postcond_errors) + + # 8. Telemetry + duration_ms = (time.time() - t0) * 1000 + backends_used = list({r.backend_used for r in step_results if r.backend_used}) + telemetry = { + "duration_ms": duration_ms, + "steps_total": len(macro.steps), + "steps_run": len(step_results), + "backends_used": backends_used, + "dry_run": dry_run, + } + + # 9. Record in session + record = RunRecord( + macro_name=macro_name, + params=params, + success=success, + output=output, + error=error, + duration_ms=duration_ms, + backends_used=backends_used, + steps_run=len(step_results), + ) + self.session.record(record) + + return ExecutionResult( + success=success, + macro_name=macro_name, + output=output, + error=error, + step_results=step_results, + telemetry=telemetry, + ) + + def check_conditions( + self, + conditions: list[MacroCondition], + params: dict, + ) -> list[str]: + """Evaluate a list of conditions; return list of failure messages.""" + errors: list[str] = [] + for cond in conditions: + err = _check_condition(cond, params) + if err: + errors.append(err) + return errors + + def validate_macro(self, macro_name: str) -> list[str]: + """Load and structurally validate a macro; return error list.""" + try: + macro = self.registry.load(macro_name) + except KeyError as exc: + return [str(exc)] + return macro.validate() + + # ── Helpers ────────────────────────────────────────────────────────── + + def _collect_outputs( + self, + macro: MacroDefinition, + params: dict, + step_results: list[StepResult], + ) -> dict: + """Resolve declared macro outputs into a concrete dict.""" + out: dict[str, Any] = {} + for output_spec in macro.outputs: + name = output_spec.name + if output_spec.path: + out[name] = substitute(output_spec.path, params) + elif output_spec.value is not None: + out[name] = substitute(output_spec.value, params) + # Always include combined step outputs under 'steps' + out["_steps"] = [r.output for r in step_results] + return out diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/core/session.py b/openclaw-skill/agent-harness/cli_anything/openclaw/core/session.py new file mode 100644 index 000000000..5c7f38a1f --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/core/session.py @@ -0,0 +1,186 @@ +"""ExecutionSession — tracks macro run history and telemetry. + +Persists run records to ~/.openclaw-macro/sessions/ so agents can inspect +what was run, what succeeded, and what the outputs were. +""" + +from __future__ import annotations + +import json +import os +import time +from pathlib import Path +from typing import Optional + +SESSION_DIR = Path.home() / ".openclaw-macro" / "sessions" +MAX_HISTORY = 200 + + +def _locked_save_json(path: str, data, **dump_kwargs) -> None: + """Atomically write JSON with exclusive file locking.""" + try: + f = open(path, "r+") + except FileNotFoundError: + os.makedirs(os.path.dirname(os.path.abspath(path)), exist_ok=True) + f = open(path, "w") + with f: + _locked = False + try: + import fcntl + fcntl.flock(f.fileno(), fcntl.LOCK_EX) + _locked = True + except (ImportError, OSError): + pass + try: + f.seek(0) + f.truncate() + json.dump(data, f, **dump_kwargs) + f.flush() + finally: + if _locked: + import fcntl + fcntl.flock(f.fileno(), fcntl.LOCK_UN) + + +class RunRecord: + """A single macro execution record.""" + + def __init__( + self, + macro_name: str, + params: dict, + success: bool, + output: dict, + error: str, + duration_ms: float, + backends_used: list[str], + steps_run: int, + timestamp: Optional[float] = None, + ): + self.macro_name = macro_name + self.params = params + self.success = success + self.output = output + self.error = error + self.duration_ms = duration_ms + self.backends_used = backends_used + self.steps_run = steps_run + self.timestamp = timestamp or time.time() + + def to_dict(self) -> dict: + return { + "macro_name": self.macro_name, + "params": self.params, + "success": self.success, + "output": self.output, + "error": self.error, + "duration_ms": self.duration_ms, + "backends_used": self.backends_used, + "steps_run": self.steps_run, + "timestamp": self.timestamp, + } + + @classmethod + def from_dict(cls, d: dict) -> "RunRecord": + return cls( + macro_name=d.get("macro_name", ""), + params=d.get("params", {}), + success=d.get("success", False), + output=d.get("output", {}), + error=d.get("error", ""), + duration_ms=d.get("duration_ms", 0), + backends_used=d.get("backends_used", []), + steps_run=d.get("steps_run", 0), + timestamp=d.get("timestamp"), + ) + + +class ExecutionSession: + """Tracks macro run history for the current session.""" + + def __init__(self, session_id: Optional[str] = None): + self.session_id = session_id or f"session_{int(time.time())}" + self._history: list[RunRecord] = [] + + # ── Record management ───────────────────────────────────────────── + + def record(self, run: RunRecord) -> None: + """Add a run record to history.""" + self._history.append(run) + if len(self._history) > MAX_HISTORY: + self._history = self._history[-MAX_HISTORY:] + + def last(self) -> Optional[RunRecord]: + """Return the most recent run record.""" + return self._history[-1] if self._history else None + + def history(self, limit: int = 20) -> list[RunRecord]: + """Return recent run records, newest first.""" + return list(reversed(self._history[-limit:])) + + def stats(self) -> dict: + """Return aggregate statistics for this session.""" + total = len(self._history) + if total == 0: + return {"total": 0, "success_rate": 0.0, "avg_duration_ms": 0.0} + successes = sum(1 for r in self._history if r.success) + avg_dur = sum(r.duration_ms for r in self._history) / total + return { + "total": total, + "success": successes, + "failure": total - successes, + "success_rate": successes / total, + "avg_duration_ms": avg_dur, + } + + def status(self) -> dict: + return { + "session_id": self.session_id, + "runs": len(self._history), + **self.stats(), + } + + # ── Persistence ─────────────────────────────────────────────────── + + def save(self) -> str: + """Persist session to disk. Returns the file path.""" + SESSION_DIR.mkdir(parents=True, exist_ok=True) + path = str(SESSION_DIR / f"{self.session_id}.json") + data = { + "session_id": self.session_id, + "timestamp": time.time(), + "history": [r.to_dict() for r in self._history], + } + _locked_save_json(path, data, indent=2, sort_keys=True) + return path + + @classmethod + def load(cls, session_id: str) -> Optional["ExecutionSession"]: + """Load a session from disk.""" + path = SESSION_DIR / f"{session_id}.json" + if not path.is_file(): + return None + with open(path, encoding="utf-8") as f: + data = json.load(f) + session = cls(session_id=data.get("session_id", session_id)) + session._history = [RunRecord.from_dict(r) for r in data.get("history", [])] + return session + + @classmethod + def list_sessions(cls) -> list[dict]: + """List all saved sessions (metadata only).""" + SESSION_DIR.mkdir(parents=True, exist_ok=True) + sessions = [] + for p in SESSION_DIR.glob("*.json"): + try: + with open(p, encoding="utf-8") as f: + d = json.load(f) + sessions.append({ + "session_id": d.get("session_id"), + "timestamp": d.get("timestamp", 0), + "runs": len(d.get("history", [])), + }) + except Exception: + continue + sessions.sort(key=lambda s: s.get("timestamp", 0), reverse=True) + return sessions diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/examples/export_file.yaml b/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/examples/export_file.yaml new file mode 100644 index 000000000..24ec1a8e4 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/examples/export_file.yaml @@ -0,0 +1,63 @@ +name: export_file +version: "1.0" +description: > + Export a file from the target application using its native CLI. + Demonstrates the native_api backend with a run_command action. + Replace the command with your actual application's export command. +tags: [export, native_api, example] + +parameters: + output: + type: string + required: true + description: Destination file path for the export. + example: /tmp/exported.txt + input: + type: string + required: false + default: "" + description: Source file to export from (optional, app-dependent). + format: + type: string + required: false + default: plain + description: Output format. + enum: [plain, json, csv] + +preconditions: + - file_exists: /bin/echo # sanity check: a real macro would check the app binary + +steps: + - id: step_export + backend: native_api + action: run_command + params: + # Replace this with your real export command, e.g.: + # command: [inkscape, --export-filename, "${output}", "${input}"] + command: [echo, "Exported to ${output} (format=${format})"] + capture_stdout: true + timeout_ms: 30000 + on_failure: fail + + - id: step_write_output + backend: file_transform + action: text_replace + params: + input_file: /dev/null + output_file: ${output} + find: "" + replace: "" + on_failure: skip # Writing the marker file is best-effort + +postconditions: [] + +outputs: + - name: exported_file + path: ${output} + description: Path where the export was written. + +agent_hints: + danger_level: safe + side_effects: [creates_file] + reversible: true + estimated_duration_ms: 2000 diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/examples/transform_json.yaml b/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/examples/transform_json.yaml new file mode 100644 index 000000000..7741a339e --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/examples/transform_json.yaml @@ -0,0 +1,52 @@ +name: transform_json +version: "1.0" +description: > + Read a JSON file, set a nested key to a new value, and write it back. + Demonstrates the file_transform backend with json_set action. +tags: [json, file_transform, example] + +parameters: + file: + type: string + required: true + description: Path to the JSON file to transform. + example: /tmp/config.json + key: + type: string + required: true + description: Dot-separated key path to set (e.g. settings.theme). + example: settings.theme + value: + type: string + required: true + description: Value to write at the key path. + example: dark + +preconditions: + - file_exists: ${file} + +steps: + - id: step_set_key + backend: file_transform + action: json_set + params: + input_file: ${file} + output_file: ${file} + path: ${key} + value: ${value} + timeout_ms: 10000 + on_failure: fail + +postconditions: + - file_exists: ${file} + +outputs: + - name: modified_file + path: ${file} + description: Path to the modified JSON file. + +agent_hints: + danger_level: moderate + side_effects: [modifies_file] + reversible: false + estimated_duration_ms: 100 diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/examples/undo_last.yaml b/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/examples/undo_last.yaml new file mode 100644 index 000000000..1475b58b3 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/examples/undo_last.yaml @@ -0,0 +1,37 @@ +name: undo_last +version: "1.0" +description: > + Trigger an undo operation in the target application using a keyboard shortcut + (Ctrl+Z). This macro demonstrates the semantic_ui backend. + On Linux, requires xdotool. On macOS/Windows, adapt to your platform. +tags: [undo, semantic_ui, example] + +parameters: + app_name: + type: string + required: false + default: "" + description: Name of the target application process (used to verify it is running). + example: inkscape + +preconditions: + - always: true # process check is optional in this example + +steps: + - id: step_undo + backend: semantic_ui + action: shortcut + params: + keys: ctrl+z + timeout_ms: 5000 + on_failure: fail + +postconditions: [] + +outputs: [] + +agent_hints: + danger_level: safe + side_effects: [modifies_app_state] + reversible: true # can be redone with ctrl+y + estimated_duration_ms: 500 diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/manifest.yaml b/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/manifest.yaml new file mode 100644 index 000000000..0b5e0db21 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/macro_definitions/manifest.yaml @@ -0,0 +1,10 @@ +macros: + - name: export_file + path: examples/export_file.yaml + version: "1.0" + - name: undo_last + path: examples/undo_last.yaml + version: "1.0" + - name: transform_json + path: examples/transform_json.yaml + version: "1.0" diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/openclaw_cli.py b/openclaw-skill/agent-harness/cli_anything/openclaw/openclaw_cli.py new file mode 100644 index 000000000..1dba50274 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/openclaw_cli.py @@ -0,0 +1,572 @@ +#!/usr/bin/env python3 +"""OpenClaw CLI — agent-callable interface for the Macro System. + +This CLI is the L6 "Unified CLI Entry" in the OpenClaw Macro System. +It provides a stable, machine-readable interface for AI agents and +power users to invoke macros without touching the GUI. + +Usage (one-shot): + cli-anything-openclaw macro run export_file --param output=/tmp/out.png --json + cli-anything-openclaw macro list --json + cli-anything-openclaw macro info export_file --json + +Usage (REPL): + cli-anything-openclaw # enters interactive REPL + cli-anything-openclaw repl +""" + +import sys +import os +import json +import click +from typing import Optional + +from cli_anything.openclaw.core.registry import MacroRegistry +from cli_anything.openclaw.core.runtime import MacroRuntime +from cli_anything.openclaw.core.session import ExecutionSession + +# ── Global state ───────────────────────────────────────────────────────────── + +_json_output = False +_repl_mode = False +_dry_run = False + +_session: Optional[ExecutionSession] = None +_runtime: Optional[MacroRuntime] = None + + +def get_runtime() -> MacroRuntime: + global _runtime, _session + if _runtime is None: + _session = _session or ExecutionSession() + _runtime = MacroRuntime(session=_session) + return _runtime + + +def get_session() -> ExecutionSession: + global _session + if _session is None: + _session = ExecutionSession() + return _session + + +# ── Output helpers ──────────────────────────────────────────────────────────── + +def output(data, message: str = ""): + """Print result: JSON in --json mode, human-readable otherwise.""" + if _json_output: + click.echo(json.dumps(data, indent=2, default=str)) + else: + if message: + click.echo(message) + _print_value(data) + + +def _print_value(val, indent: int = 0): + prefix = " " * indent + if isinstance(val, dict): + for k, v in val.items(): + if isinstance(v, (dict, list)): + click.echo(f"{prefix}{k}:") + _print_value(v, indent + 1) + else: + click.echo(f"{prefix}{k}: {v}") + elif isinstance(val, list): + for i, item in enumerate(val): + if isinstance(item, dict): + click.echo(f"{prefix}[{i}]") + _print_value(item, indent + 1) + else: + click.echo(f"{prefix}- {item}") + else: + click.echo(f"{prefix}{val}") + + +def handle_error(func): + """Decorator: consistent error handling across commands.""" + import functools + + @functools.wraps(func) + def wrapper(*args, **kwargs): + try: + return func(*args, **kwargs) + except KeyError as e: + msg = str(e).strip("'\"") + if _json_output: + click.echo(json.dumps({"error": msg, "type": "not_found"})) + else: + click.echo(f"Error: {msg}", err=True) + if not _repl_mode: + sys.exit(1) + except FileNotFoundError as e: + if _json_output: + click.echo(json.dumps({"error": str(e), "type": "file_not_found"})) + else: + click.echo(f"Error: {e}", err=True) + if not _repl_mode: + sys.exit(1) + except Exception as e: + if _json_output: + click.echo(json.dumps({"error": str(e), "type": type(e).__name__})) + else: + click.echo(f"Error: {e}", err=True) + if not _repl_mode: + sys.exit(1) + + return wrapper + + +# ── Parameter parsing ───────────────────────────────────────────────────────── + +def _parse_params(param_tuples: tuple) -> dict: + """Convert --param key=value tuples to a dict.""" + result = {} + for pair in param_tuples: + if "=" in pair: + k, v = pair.split("=", 1) + result[k.strip()] = v.strip() + else: + click.echo(f"Warning: --param '{pair}' ignored (expected key=value format).", err=True) + return result + + +# ── Main CLI group ──────────────────────────────────────────────────────────── + +@click.group(invoke_without_command=True) +@click.option("--json", "json_flag", is_flag=True, help="Machine-readable JSON output.") +@click.option("--dry-run", "dry_run_flag", is_flag=True, + help="Simulate execution without side effects.") +@click.option("--session-id", default=None, help="Resume or create a named session.") +@click.pass_context +def cli(ctx, json_flag, dry_run_flag, session_id): + """OpenClaw Macro System — run GUI workflows as CLI commands. + + \b + Quick start: + cli-anything-openclaw macro list + cli-anything-openclaw macro info + cli-anything-openclaw macro run --param key=value + + Enter interactive REPL by running without arguments. + """ + global _json_output, _dry_run, _session + + _json_output = json_flag + _dry_run = dry_run_flag + + if session_id: + loaded = ExecutionSession.load(session_id) + _session = loaded or ExecutionSession(session_id=session_id) + + ctx.ensure_object(dict) + + if ctx.invoked_subcommand is None: + ctx.invoke(repl) + + +# ── macro group ────────────────────────────────────────────────────────────── + +@cli.group() +def macro(): + """Macro management and execution.""" + + +@macro.command("run") +@click.argument("name") +@click.option("--param", "-p", multiple=True, + help="Macro parameter in key=value format. Repeat for multiple.") +@handle_error +def macro_run(name, param): + """Execute a macro by name. + + \b + Example: + macro run export_file --param output=/tmp/out.txt + macro run export_file -p output=/tmp/out.txt -p format=plain --json + """ + params = _parse_params(param) + runtime = get_runtime() + result = runtime.execute(name, params, dry_run=_dry_run) + + if _json_output: + output(result.to_dict()) + else: + if result.success: + click.echo(f"✓ Macro '{name}' completed successfully.") + if result.output: + for k, v in result.output.items(): + if not k.startswith("_"): + click.echo(f" {k}: {v}") + else: + click.echo(f"✗ Macro '{name}' failed.", err=True) + click.echo(f" {result.error}", err=True) + if result.telemetry: + click.echo( + f" [{result.telemetry.get('duration_ms', 0):.0f}ms, " + f"backends: {', '.join(result.telemetry.get('backends_used', []))}]" + ) + if not result.success and not _repl_mode: + sys.exit(1) + + +@macro.command("list") +@handle_error +def macro_list(): + """List all available macros.""" + runtime = get_runtime() + macros = runtime.registry.list_all() + + if _json_output: + output([{ + "name": m.name, + "version": m.version, + "description": m.description, + "tags": m.tags, + "parameters": list(m.parameters.keys()), + } for m in macros]) + else: + if not macros: + click.echo("No macros found.") + return + click.echo(f"Available macros ({len(macros)}):\n") + for m in macros: + tags = f" [{', '.join(m.tags)}]" if m.tags else "" + click.echo(f" {m.name:<30} {m.description}{tags}") + + +@macro.command("info") +@click.argument("name") +@handle_error +def macro_info(name): + """Show full details for a macro (schema, parameters, steps).""" + runtime = get_runtime() + m = runtime.registry.load(name) + + if _json_output: + output(m.to_dict()) + else: + click.echo(f"\nMacro: {m.name} (v{m.version})") + click.echo(f" {m.description}\n") + + if m.parameters: + click.echo("Parameters:") + for pname, pspec in m.parameters.items(): + req = "(required)" if pspec.required else f"(default: {pspec.default!r})" + click.echo(f" --param {pname}=<{pspec.type}> {req}") + if pspec.description: + click.echo(f" {pspec.description}") + + if m.preconditions: + click.echo(f"\nPreconditions ({len(m.preconditions)}):") + for c in m.preconditions: + click.echo(f" {c.type}: {c.args}") + + if m.steps: + click.echo(f"\nSteps ({len(m.steps)}):") + for s in m.steps: + click.echo(f" [{s.id}] backend={s.backend} action={s.action}") + + if m.postconditions: + click.echo(f"\nPostconditions ({len(m.postconditions)}):") + for c in m.postconditions: + click.echo(f" {c.type}: {c.args}") + + if m.outputs: + click.echo(f"\nOutputs:") + for o in m.outputs: + click.echo(f" {o.name}: {o.path or o.value}") + + if m.agent_hints: + click.echo(f"\nAgent hints: {m.agent_hints}") + click.echo() + + +@macro.command("validate") +@click.argument("name", required=False) +@handle_error +def macro_validate(name): + """Validate macro definition(s). Pass a name or omit to validate all.""" + runtime = get_runtime() + + if name: + names = [name] + else: + names = runtime.registry.list_names() + + results = {} + for n in names: + errors = runtime.validate_macro(n) + results[n] = errors + + if _json_output: + output({n: {"valid": len(e) == 0, "errors": e} for n, e in results.items()}) + else: + all_ok = True + for n, errors in results.items(): + if errors: + all_ok = False + click.echo(f"✗ {n}:") + for err in errors: + click.echo(f" - {err}", err=True) + else: + click.echo(f"✓ {n}") + if all_ok: + click.echo("\nAll macros valid.") + else: + if not _repl_mode: + sys.exit(1) + + +@macro.command("dry-run") +@click.argument("name") +@click.option("--param", "-p", multiple=True, help="Parameter in key=value format.") +@handle_error +def macro_dry_run(name, param): + """Simulate macro execution without any side effects.""" + params = _parse_params(param) + runtime = get_runtime() + result = runtime.execute(name, params, dry_run=True) + + if _json_output: + output(result.to_dict()) + else: + click.echo(f"[dry-run] Macro '{name}'") + if result.success: + click.echo(" Would execute successfully.") + click.echo(f" Steps: {len(result.step_results)}") + else: + click.echo(f" Would fail: {result.error}", err=True) + + +@macro.command("define") +@click.argument("name") +@click.option("--output", "-o", default=None, help="Write YAML to this file path.") +@handle_error +def macro_define(name, output): + """Scaffold a new macro YAML definition.""" + import textwrap + template = textwrap.dedent(f"""\ + name: {name} + version: "1.0" + description: "Describe what this macro does." + tags: [] + + parameters: + # Add your parameters here + # output: + # type: string + # required: true + # description: Output file path + # example: /tmp/result.txt + + preconditions: + # Conditions that must be true before execution + # - file_exists: /path/to/input + # - process_running: my-app + + steps: + - id: step_1 + backend: native_api # or: file_transform, semantic_ui, gui_macro + action: run_command + params: + command: [echo, "Hello from {name}"] + timeout_ms: 30000 + on_failure: fail # or: skip, continue + + postconditions: + # Conditions verified after execution + # - file_exists: ${{output}} + + outputs: + # Named outputs the agent can use + # - name: result_file + # path: ${{output}} + + agent_hints: + danger_level: safe # safe | moderate | dangerous + side_effects: [] + reversible: true + """) + if output: + from pathlib import Path + p = Path(output) + p.parent.mkdir(parents=True, exist_ok=True) + p.write_text(template, encoding="utf-8") + if _json_output: + click.echo(json.dumps({"created": str(p.resolve())})) + else: + click.echo(f"✓ Macro scaffold written to: {p.resolve()}") + else: + click.echo(template) + + +# ── session group ───────────────────────────────────────────────────────────── + +@cli.group() +def session(): + """Session management and run history.""" + + +@session.command("status") +@handle_error +def session_status(): + """Show current session status and statistics.""" + sess = get_session() + data = sess.status() + output(data, "Session status:") + + +@session.command("history") +@click.option("--limit", default=10, show_default=True, help="Number of records to show.") +@handle_error +def session_history(limit): + """Show recent macro execution history.""" + sess = get_session() + records = sess.history(limit=limit) + + if _json_output: + output([r.to_dict() for r in records]) + else: + if not records: + click.echo("No runs recorded in this session.") + return + click.echo(f"Recent runs ({len(records)}):\n") + for r in records: + status = "✓" if r.success else "✗" + import datetime + ts = datetime.datetime.fromtimestamp(r.timestamp).strftime("%H:%M:%S") + click.echo(f" {status} [{ts}] {r.macro_name} ({r.duration_ms:.0f}ms)") + if not r.success: + click.echo(f" Error: {r.error}", err=True) + + +@session.command("save") +@handle_error +def session_save(): + """Persist current session to disk.""" + sess = get_session() + path = sess.save() + output({"saved": path, "session_id": sess.session_id}, + f"Session saved: {path}") + + +@session.command("list") +@handle_error +def session_list(): + """List all saved sessions.""" + sessions = ExecutionSession.list_sessions() + if _json_output: + output(sessions) + else: + if not sessions: + click.echo("No saved sessions.") + return + click.echo("Saved sessions:\n") + for s in sessions: + import datetime + ts = datetime.datetime.fromtimestamp(s.get("timestamp", 0)).strftime("%Y-%m-%d %H:%M:%S") + click.echo(f" {s['session_id']} ({s['runs']} runs) {ts}") + + +# ── backends command ────────────────────────────────────────────────────────── + +@cli.command() +@handle_error +def backends(): + """Show available execution backends and their status.""" + runtime = get_runtime() + data = runtime.routing.describe() + if _json_output: + output(data) + else: + click.echo("Execution backends:\n") + for name, info in sorted(data.items(), key=lambda x: -x[1].get("priority", 0)): + status = "✓" if info.get("available") else "✗" + click.echo( + f" {status} {name:<20} priority={info.get('priority', '?'):<5}" + f" available={info.get('available')}" + ) + + +# ── repl command ────────────────────────────────────────────────────────────── + +@cli.command() +@click.pass_context +def repl(ctx): + """Enter the interactive REPL (default when no command given).""" + global _repl_mode + _repl_mode = True + + from cli_anything.openclaw.utils.repl_skin import ReplSkin + skin = ReplSkin("openclaw", version="1.0.0") + skin.print_banner() + + runtime = get_runtime() + + # Show quick summary on startup + macros = runtime.registry.list_all() + skin.info(f"{len(macros)} macros loaded. Type 'macro list' to see them.") + skin.info("Type 'help' for commands, 'quit' to exit.\n") + + pt_session = skin.create_prompt_session() + session_obj = get_session() + + while True: + try: + line = skin.get_input( + pt_session, + context=f"{session_obj.session_id[:12]}", + ) + except (EOFError, KeyboardInterrupt): + skin.print_goodbye() + break + + if not line: + continue + if line.lower() in ("quit", "exit", "q"): + skin.print_goodbye() + break + if line.lower() in ("help", "?"): + skin.help({ + "macro list": "List all available macros", + "macro info ": "Show macro schema", + "macro run [--param k=v ...]": "Execute a macro", + "macro dry-run ": "Simulate without side effects", + "macro validate [name]": "Validate macro definitions", + "macro define ": "Scaffold a new macro YAML", + "session status": "Show session statistics", + "session history": "Show recent runs", + "backends": "Show backend availability", + "quit": "Exit the REPL", + }) + continue + + # Parse and dispatch via Click's standalone_mode=False + import shlex + try: + args = shlex.split(line) + except ValueError as e: + skin.error(f"Parse error: {e}") + continue + + try: + ctx_obj = cli.make_context( + "cli-anything-openclaw", + args, + standalone_mode=False, + parent=ctx, + ) + with ctx_obj: + cli.invoke(ctx_obj) + except SystemExit: + pass + except click.ClickException as e: + skin.error(str(e)) + except Exception as e: + skin.error(str(e)) + + +# ── Entry point ─────────────────────────────────────────────────────────────── + +if __name__ == "__main__": + cli() diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/skills/SKILL.md b/openclaw-skill/agent-harness/cli_anything/openclaw/skills/SKILL.md new file mode 100644 index 000000000..c5e09d1b6 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/skills/SKILL.md @@ -0,0 +1,220 @@ +--- +name: cli-anything-openclaw +description: > + Use when the agent wants to define, list, inspect, or execute GUI macros + via the OpenClaw Macro System CLI. Macros are parameterized, CLI-callable + workflows — the agent invokes `macro run ` and the system handles + backend routing (plugin, file transform, accessibility, compiled GUI replay). +--- + +# OpenClaw Macro System CLI + +## What It Is + +The OpenClaw Macro System converts valuable GUI workflows into parameterized, +CLI-callable macros. Agents **never touch the GUI directly** — they call macros +through this stable CLI, and the runtime routes execution to the best available +backend (native plugin/API, file transformation, semantic UI control, or +precompiled GUI macro replay). + +## Installation + +```bash +cd openclaw-skill/agent-harness +pip install -e . +``` + +**Requirements:** Python 3.10+, PyYAML, click, prompt-toolkit. + +## Quick Start (for agents) + +```bash +# 1. See what macros are available +cli-anything-openclaw macro list --json + +# 2. Inspect a macro's parameters +cli-anything-openclaw macro info export_file --json + +# 3. Dry-run to check params without side effects +cli-anything-openclaw --dry-run macro run export_file \ + --param output=/tmp/test.txt --json + +# 4. Execute a macro +cli-anything-openclaw macro run export_file \ + --param output=/tmp/result.txt --json + +# 5. See what backends are available +cli-anything-openclaw backends --json +``` + +## Command Reference + +### Global Flags + +| Flag | Description | +|------|-------------| +| `--json` | Machine-readable JSON output on stdout | +| `--dry-run` | Simulate all steps, skip side effects | +| `--session-id ` | Resume or create a named session | + +### `macro` group + +| Command | Description | +|---------|-------------| +| `macro list` | List all available macros | +| `macro info ` | Show macro schema (parameters, steps, conditions) | +| `macro run --param k=v` | Execute a macro | +| `macro dry-run --param k=v` | Simulate without side effects | +| `macro validate [name]` | Structural validation | +| `macro define ` | Scaffold a new macro YAML | + +### `session` group + +| Command | Description | +|---------|-------------| +| `session status` | Show session statistics | +| `session history` | Show recent run history | +| `session save` | Persist session to disk | +| `session list` | List all saved sessions | + +### `backends` + +```bash +cli-anything-openclaw backends --json +# Shows: native_api, file_transform, semantic_ui, gui_macro, recovery +# and whether each is available in the current environment. +``` + +## Macro Parameters + +Pass parameters with `--param key=value`. Repeat for multiple: + +```bash +cli-anything-openclaw macro run transform_json \ + --param file=/path/to/data.json \ + --param key=settings.theme \ + --param value=dark \ + --json +``` + +## Output Format (--json) + +All commands output JSON when `--json` is set: + +```json +{ + "success": true, + "macro_name": "export_file", + "output": { + "exported_file": "/tmp/result.txt" + }, + "error": "", + "telemetry": { + "duration_ms": 312, + "steps_total": 2, + "steps_run": 2, + "backends_used": ["native_api"], + "dry_run": false + } +} +``` + +On failure (`"success": false`), read the `"error"` field for the reason. +Exit code is 1 on failure. + +## Execution Backends + +Backends are selected automatically based on the macro step definition: + +| Backend | Triggered by | Use case | +|---------|-------------|----------| +| `native_api` | `backend: native_api` | Subprocess / shell command | +| `file_transform` | `backend: file_transform` | XML, JSON, text file editing | +| `semantic_ui` | `backend: semantic_ui` | Accessibility / keyboard shortcuts | +| `gui_macro` | `backend: gui_macro` | Precompiled coordinate replay | +| `recovery` | `backend: recovery` | Retry / fallback orchestration | + +## Writing Macros + +Macros are YAML files in `cli_anything/openclaw/macro_definitions/`. +Scaffold one with: + +```bash +cli-anything-openclaw macro define my_macro --output \ + cli_anything/openclaw/macro_definitions/examples/my_macro.yaml +``` + +Minimal schema: + +```yaml +name: my_macro +version: "1.0" +description: What this macro does. + +parameters: + output: + type: string + required: true + description: Where to write results. + example: /tmp/result.txt + +preconditions: + - file_exists: /path/to/input + +steps: + - id: step1 + backend: native_api + action: run_command + params: + command: [my-app, --export, "${output}"] + timeout_ms: 30000 + on_failure: fail # or: skip, continue + +postconditions: + - file_exists: ${output} + - file_size_gt: [${output}, 100] + +outputs: + - name: result_file + path: ${output} + +agent_hints: + danger_level: safe # safe | moderate | dangerous + side_effects: [creates_file] + reversible: true +``` + +## Agent Usage Rules + +1. **Always use `--json`** for programmatic output. +2. **Use `--dry-run` to validate params** before executing side-effectful macros. +3. **Check `success` field** — do not assume success from exit code alone. +4. **Read `error` field** when `success` is false — it explains what failed. +5. **Use `macro info ` to discover params** before calling `macro run`. +6. **Use absolute paths** for all file parameters. + +## Example Workflow + +```bash +# Step 1: What's available? +cli-anything-openclaw macro list --json + +# Step 2: What params does transform_json need? +cli-anything-openclaw macro info transform_json --json + +# Step 3: Test safely +cli-anything-openclaw --dry-run macro run transform_json \ + --param file=/tmp/config.json \ + --param key=theme \ + --param value=dark --json + +# Step 4: Execute for real +cli-anything-openclaw macro run transform_json \ + --param file=/tmp/config.json \ + --param key=theme \ + --param value=dark --json +``` + +## Version + +1.0.0 diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/tests/__init__.py b/openclaw-skill/agent-harness/cli_anything/openclaw/tests/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/tests/test_core.py b/openclaw-skill/agent-harness/cli_anything/openclaw/tests/test_core.py new file mode 100644 index 000000000..e68b018dd --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/tests/test_core.py @@ -0,0 +1,595 @@ +"""Unit tests for OpenClaw Macro System core modules. + +Covers: MacroDefinition, MacroRegistry, MacroRuntime, backends, routing. +All tests use synthetic data and do not require external software. +""" + +import json +import os +import sys +import textwrap +import tempfile +from pathlib import Path + +import pytest + +# ── Helpers ─────────────────────────────────────────────────────────────────── + +SIMPLE_MACRO_YAML = textwrap.dedent("""\ + name: test_macro + version: "1.0" + description: A test macro. + parameters: + output: + type: string + required: true + description: Output path + count: + type: integer + required: false + default: 1 + min: 1 + max: 100 + steps: + - id: step1 + backend: native_api + action: run_command + params: + command: [echo, hello] + postconditions: [] +""") + + +def write_macro(tmp_path: Path, name: str, content: str) -> Path: + p = tmp_path / f"{name}.yaml" + p.write_text(content, encoding="utf-8") + return p + + +# ── macro_model tests ───────────────────────────────────────────────────────── + +class TestMacroModel: + def test_load_from_yaml(self, tmp_path): + from cli_anything.openclaw.core.macro_model import load_from_yaml + p = write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + m = load_from_yaml(str(p)) + assert m.name == "test_macro" + assert m.version == "1.0" + assert "output" in m.parameters + assert len(m.steps) == 1 + assert m.steps[0].backend == "native_api" + + def test_load_missing_file(self): + from cli_anything.openclaw.core.macro_model import load_from_yaml + with pytest.raises(FileNotFoundError): + load_from_yaml("/nonexistent/path.yaml") + + def test_validate_params_required(self, tmp_path): + from cli_anything.openclaw.core.macro_model import load_from_yaml + p = write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + m = load_from_yaml(str(p)) + errors = m.validate_params({}) + assert any("output" in e for e in errors) + + def test_validate_params_type_error(self, tmp_path): + from cli_anything.openclaw.core.macro_model import load_from_yaml + p = write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + m = load_from_yaml(str(p)) + errors = m.validate_params({"output": "/tmp/x", "count": "not_an_int"}) + assert any("count" in e for e in errors) + + def test_validate_params_range(self, tmp_path): + from cli_anything.openclaw.core.macro_model import load_from_yaml + p = write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + m = load_from_yaml(str(p)) + errors = m.validate_params({"output": "/tmp/x", "count": 200}) + assert any("count" in e for e in errors) + + def test_validate_params_ok(self, tmp_path): + from cli_anything.openclaw.core.macro_model import load_from_yaml + p = write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + m = load_from_yaml(str(p)) + errors = m.validate_params({"output": "/tmp/x"}) + assert errors == [] + + def test_resolve_params_defaults(self, tmp_path): + from cli_anything.openclaw.core.macro_model import load_from_yaml + p = write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + m = load_from_yaml(str(p)) + resolved = m.resolve_params({"output": "/tmp/x"}) + assert resolved["count"] == 1 + + def test_structural_validation_no_steps(self, tmp_path): + from cli_anything.openclaw.core.macro_model import load_from_yaml + yaml_content = "name: bad\nsteps: []\n" + p = write_macro(tmp_path, "bad", yaml_content) + m = load_from_yaml(str(p)) + errors = m.validate() + assert any("steps" in e for e in errors) + + def test_structural_validation_bad_backend(self, tmp_path): + from cli_anything.openclaw.core.macro_model import load_from_yaml + yaml_content = textwrap.dedent("""\ + name: bad + steps: + - id: x + backend: fake_backend + action: do_thing + """) + p = write_macro(tmp_path, "bad_backend", yaml_content) + m = load_from_yaml(str(p)) + errors = m.validate() + assert any("fake_backend" in e for e in errors) + + def test_to_dict(self, tmp_path): + from cli_anything.openclaw.core.macro_model import load_from_yaml + p = write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + m = load_from_yaml(str(p)) + d = m.to_dict() + assert d["name"] == "test_macro" + assert "parameters" in d + assert "steps" in d + + +class TestSubstitute: + def test_string_substitution(self): + from cli_anything.openclaw.core.macro_model import substitute + result = substitute("hello ${name}", {"name": "world"}) + assert result == "hello world" + + def test_nested_list(self): + from cli_anything.openclaw.core.macro_model import substitute + result = substitute(["echo", "${output}"], {"output": "/tmp/x"}) + assert result == ["echo", "/tmp/x"] + + def test_nested_dict(self): + from cli_anything.openclaw.core.macro_model import substitute + result = substitute({"path": "${output}", "other": 42}, {"output": "/out"}) + assert result["path"] == "/out" + assert result["other"] == 42 + + def test_missing_key_left_as_is(self): + from cli_anything.openclaw.core.macro_model import substitute + result = substitute("${missing}", {}) + assert result == "${missing}" + + +# ── MacroRegistry tests ─────────────────────────────────────────────────────── + +class TestMacroRegistry: + def test_load_macro(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + reg = MacroRegistry(str(tmp_path)) + m = reg.load("test_macro") + assert m.name == "test_macro" + + def test_load_missing_raises(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + reg = MacroRegistry(str(tmp_path)) + with pytest.raises(KeyError): + reg.load("nonexistent_macro") + + def test_list_all(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + write_macro(tmp_path, "another", SIMPLE_MACRO_YAML.replace("test_macro", "another")) + reg = MacroRegistry(str(tmp_path)) + names = reg.list_names() + assert "test_macro" in names + assert "another" in names + + def test_manifest_index(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + sub = tmp_path / "sub" + sub.mkdir() + write_macro(sub, "alpha", SIMPLE_MACRO_YAML.replace("test_macro", "alpha")) + manifest = tmp_path / "manifest.yaml" + manifest.write_text("macros:\n - name: alpha\n path: sub/alpha.yaml\n") + reg = MacroRegistry(str(tmp_path)) + m = reg.load("alpha") + assert m.name == "alpha" + + def test_register_programmatic(self): + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.macro_model import MacroDefinition, MacroStep + reg = MacroRegistry("/nonexistent") + macro = MacroDefinition( + name="inline_macro", + steps=[MacroStep(backend="native_api", action="run_command")], + ) + reg.register(macro) + assert reg.load("inline_macro").name == "inline_macro" + + def test_info(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + write_macro(tmp_path, "test_macro", SIMPLE_MACRO_YAML) + reg = MacroRegistry(str(tmp_path)) + info = reg.info() + assert info["total"] >= 1 + assert "macros_dir" in info + + +# ── Backend tests ───────────────────────────────────────────────────────────── + +class TestNativeAPIBackend: + def _make_context(self, params=None): + from cli_anything.openclaw.backends.base import BackendContext + return BackendContext(params=params or {}) + + def _make_step(self, action, step_params): + from cli_anything.openclaw.core.macro_model import MacroStep + return MacroStep(id="test", backend="native_api", action=action, params=step_params) + + def test_run_command_success(self): + from cli_anything.openclaw.backends.native_api import NativeAPIBackend + b = NativeAPIBackend() + step = self._make_step("run_command", {"command": ["echo", "hello"]}) + result = b.execute(step, {}, self._make_context()) + assert result.success + + def test_run_command_fails_bad_exit(self): + from cli_anything.openclaw.backends.native_api import NativeAPIBackend + b = NativeAPIBackend() + step = self._make_step("run_command", {"command": ["false"]}) + result = b.execute(step, {}, self._make_context()) + assert not result.success + assert "exit" in result.error.lower() or "failed" in result.error.lower() + + def test_run_command_not_found(self): + from cli_anything.openclaw.backends.native_api import NativeAPIBackend + b = NativeAPIBackend() + step = self._make_step("run_command", {"command": ["__nonexistent_cmd__"]}) + result = b.execute(step, {}, self._make_context()) + assert not result.success + + def test_find_executable_found(self): + from cli_anything.openclaw.backends.native_api import NativeAPIBackend + b = NativeAPIBackend() + step = self._make_step("find_executable", {"name": "echo"}) + result = b.execute(step, {}, self._make_context()) + assert result.success + assert "executable" in result.output + + def test_find_executable_missing(self): + from cli_anything.openclaw.backends.native_api import NativeAPIBackend + b = NativeAPIBackend() + step = self._make_step("find_executable", { + "name": "__nonexistent__", + "install_hint": "brew install nonexistent" + }) + result = b.execute(step, {}, self._make_context()) + assert not result.success + assert "brew install" in result.error + + def test_dry_run_does_not_execute(self): + from cli_anything.openclaw.backends.native_api import NativeAPIBackend + from cli_anything.openclaw.backends.base import BackendContext + b = NativeAPIBackend() + step = self._make_step("run_command", {"command": ["false"]}) + ctx = BackendContext(params={}, dry_run=True) + result = b.execute(step, {}, ctx) + assert result.success + assert result.output.get("dry_run") + + def test_param_substitution_in_command(self): + from cli_anything.openclaw.backends.native_api import NativeAPIBackend + b = NativeAPIBackend() + step = self._make_step("run_command", {"command": ["echo", "${msg}"]}) + result = b.execute(step, {"msg": "substituted"}, self._make_context({"msg": "substituted"})) + assert result.success + + def test_unknown_action(self): + from cli_anything.openclaw.backends.native_api import NativeAPIBackend + b = NativeAPIBackend() + step = self._make_step("unknown_action", {}) + result = b.execute(step, {}, self._make_context()) + assert not result.success + assert "unknown action" in result.error.lower() + + +class TestFileTransformBackend: + def _make_context(self): + from cli_anything.openclaw.backends.base import BackendContext + return BackendContext(params={}) + + def test_json_set_and_get(self, tmp_path): + from cli_anything.openclaw.backends.file_transform import FileTransformBackend + from cli_anything.openclaw.core.macro_model import MacroStep + b = FileTransformBackend() + ctx = self._make_context() + + json_file = tmp_path / "data.json" + json_file.write_text('{"a": 1}', encoding="utf-8") + + step = MacroStep(id="set", backend="file_transform", action="json_set", params={ + "input_file": str(json_file), + "output_file": str(json_file), + "path": "settings.theme", + "value": "dark", + }) + result = b.execute(step, {}, ctx) + assert result.success + + import json + data = json.loads(json_file.read_text()) + assert data["settings"]["theme"] == "dark" + + def test_text_replace(self, tmp_path): + from cli_anything.openclaw.backends.file_transform import FileTransformBackend + from cli_anything.openclaw.core.macro_model import MacroStep + b = FileTransformBackend() + ctx = self._make_context() + + txt_file = tmp_path / "config.ini" + txt_file.write_text("theme=default\nsize=10\n", encoding="utf-8") + + step = MacroStep(id="replace", backend="file_transform", action="text_replace", params={ + "input_file": str(txt_file), + "output_file": str(txt_file), + "find": "theme=default", + "replace": "theme=dark", + }) + result = b.execute(step, {}, ctx) + assert result.success + assert "theme=dark" in txt_file.read_text() + assert result.output["replacements"] == 1 + + def test_copy_file(self, tmp_path): + from cli_anything.openclaw.backends.file_transform import FileTransformBackend + from cli_anything.openclaw.core.macro_model import MacroStep + b = FileTransformBackend() + ctx = self._make_context() + + src = tmp_path / "src.txt" + dst = tmp_path / "dst.txt" + src.write_text("content", encoding="utf-8") + + step = MacroStep(id="copy", backend="file_transform", action="copy_file", params={ + "src": str(src), + "dst": str(dst), + }) + result = b.execute(step, {}, ctx) + assert result.success + assert dst.read_text() == "content" + + def test_unknown_action(self): + from cli_anything.openclaw.backends.file_transform import FileTransformBackend + from cli_anything.openclaw.core.macro_model import MacroStep + b = FileTransformBackend() + step = MacroStep(id="x", backend="file_transform", action="unknown_op", params={}) + result = b.execute(step, {}, self._make_context()) + assert not result.success + + +class TestStepResult: + def test_to_dict(self): + from cli_anything.openclaw.backends.base import StepResult + r = StepResult(success=True, output={"key": "val"}, backend_used="native_api") + d = r.to_dict() + assert d["success"] is True + assert d["output"]["key"] == "val" + assert d["backend_used"] == "native_api" + + +# ── Routing tests ───────────────────────────────────────────────────────────── + +class TestRoutingEngine: + def test_select_native_api(self): + from cli_anything.openclaw.core.routing import RoutingEngine + from cli_anything.openclaw.core.macro_model import MacroStep + engine = RoutingEngine() + step = MacroStep(id="x", backend="native_api", action="run_command") + backend = engine.select(step) + assert backend.name == "native_api" + + def test_select_file_transform(self): + from cli_anything.openclaw.core.routing import RoutingEngine + from cli_anything.openclaw.core.macro_model import MacroStep + engine = RoutingEngine() + step = MacroStep(id="x", backend="file_transform", action="json_set") + backend = engine.select(step) + assert backend.name == "file_transform" + + def test_describe(self): + from cli_anything.openclaw.core.routing import RoutingEngine + engine = RoutingEngine() + desc = engine.describe() + assert "native_api" in desc + assert "file_transform" in desc + assert "recovery" in desc + + def test_execute_step_native_api(self): + from cli_anything.openclaw.core.routing import RoutingEngine + from cli_anything.openclaw.core.macro_model import MacroStep + from cli_anything.openclaw.backends.base import BackendContext + engine = RoutingEngine() + step = MacroStep(id="x", backend="native_api", action="run_command", + params={"command": ["echo", "hello"]}) + ctx = BackendContext(params={}) + result = engine.execute_step(step, {}, ctx) + assert result.success + + +# ── Runtime tests ───────────────────────────────────────────────────────────── + +class TestMacroRuntime: + def _make_runtime(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + # Register a real macro that just echoes + yaml_content = textwrap.dedent("""\ + name: echo_macro + parameters: + msg: + type: string + required: false + default: hello + steps: + - id: step1 + backend: native_api + action: run_command + params: + command: [echo, "${msg}"] + """) + write_macro(tmp_path, "echo_macro", yaml_content) + reg = MacroRegistry(str(tmp_path)) + return MacroRuntime(registry=reg) + + def test_execute_success(self, tmp_path): + rt = self._make_runtime(tmp_path) + result = rt.execute("echo_macro", {"msg": "test"}) + assert result.success + assert result.telemetry["steps_run"] == 1 + + def test_execute_unknown_macro(self, tmp_path): + rt = self._make_runtime(tmp_path) + result = rt.execute("nonexistent_macro", {}) + assert not result.success + assert "not found" in result.error.lower() + + def test_execute_param_validation_failure(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + yaml_content = textwrap.dedent("""\ + name: required_param_macro + parameters: + output: + type: string + required: true + steps: + - id: s1 + backend: native_api + action: run_command + params: + command: [echo, "${output}"] + """) + write_macro(tmp_path, "required_param_macro", yaml_content) + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("required_param_macro", {}) + assert not result.success + assert "output" in result.error + + def test_precondition_failure(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + yaml_content = textwrap.dedent("""\ + name: precond_macro + preconditions: + - file_exists: /nonexistent_file_xyz_abc + steps: + - id: s1 + backend: native_api + action: run_command + params: + command: [echo, ok] + """) + write_macro(tmp_path, "precond_macro", yaml_content) + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("precond_macro", {}) + assert not result.success + assert "precondition" in result.error.lower() + + def test_postcondition_failure(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + yaml_content = textwrap.dedent("""\ + name: postcond_macro + steps: + - id: s1 + backend: native_api + action: run_command + params: + command: [echo, ok] + postconditions: + - file_exists: /nonexistent_output_xyz + """) + write_macro(tmp_path, "postcond_macro", yaml_content) + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("postcond_macro", {}) + assert not result.success + assert "postcondition" in result.error.lower() + + def test_dry_run(self, tmp_path): + rt = self._make_runtime(tmp_path) + result = rt.execute("echo_macro", {}, dry_run=True) + assert result.success + assert result.telemetry["dry_run"] is True + + def test_session_records_run(self, tmp_path): + rt = self._make_runtime(tmp_path) + rt.execute("echo_macro", {}) + last = rt.session.last() + assert last is not None + assert last.macro_name == "echo_macro" + + def test_validate_macro(self, tmp_path): + rt = self._make_runtime(tmp_path) + errors = rt.validate_macro("echo_macro") + assert errors == [] + + def test_on_failure_skip(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + yaml_content = textwrap.dedent("""\ + name: skip_macro + steps: + - id: bad_step + backend: native_api + action: run_command + params: + command: [false] + on_failure: skip + - id: good_step + backend: native_api + action: run_command + params: + command: [echo, reached] + """) + write_macro(tmp_path, "skip_macro", yaml_content) + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("skip_macro", {}) + # Should succeed because bad step was skipped + assert result.success + assert result.telemetry["steps_run"] == 2 + + +# ── Session tests ───────────────────────────────────────────────────────────── + +class TestExecutionSession: + def test_record_and_retrieve(self): + from cli_anything.openclaw.core.session import ExecutionSession, RunRecord + sess = ExecutionSession(session_id="test_sess") + rec = RunRecord("m1", {}, True, {}, "", 100.0, ["native_api"], 1) + sess.record(rec) + assert sess.last().macro_name == "m1" + assert len(sess.history()) == 1 + + def test_stats(self): + from cli_anything.openclaw.core.session import ExecutionSession, RunRecord + sess = ExecutionSession() + sess.record(RunRecord("m1", {}, True, {}, "", 100.0, [], 1)) + sess.record(RunRecord("m2", {}, False, {}, "err", 50.0, [], 0)) + stats = sess.stats() + assert stats["total"] == 2 + assert stats["success"] == 1 + assert stats["success_rate"] == 0.5 + + def test_save_and_load(self, tmp_path, monkeypatch): + from cli_anything.openclaw.core import session as sess_mod + import cli_anything.openclaw.core.session as sess_module + # Redirect SESSION_DIR to tmp_path + monkeypatch.setattr(sess_module, "SESSION_DIR", tmp_path) + from cli_anything.openclaw.core.session import ExecutionSession, RunRecord + sess = ExecutionSession(session_id="save_test") + sess.record(RunRecord("m1", {"k": "v"}, True, {}, "", 200.0, ["native_api"], 1)) + sess.save() + + loaded = ExecutionSession.load("save_test") + assert loaded is not None + assert loaded.session_id == "save_test" + assert loaded.last().macro_name == "m1" diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/tests/test_full_e2e.py b/openclaw-skill/agent-harness/cli_anything/openclaw/tests/test_full_e2e.py new file mode 100644 index 000000000..d7cde9a94 --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/tests/test_full_e2e.py @@ -0,0 +1,369 @@ +"""End-to-end integration tests for the OpenClaw Macro System. + +Tests the full lifecycle: macro discovery → runtime execution → CLI subprocess. +Uses real file I/O and subprocess calls (echo, cat, etc.) as the "target apps". +""" + +import json +import os +import subprocess +import sys +import tempfile +import textwrap +from pathlib import Path + +import pytest + + +# ── CLI resolver (same pattern as in HARNESS.md) ───────────────────────────── + +def _resolve_cli(name: str) -> list[str]: + """Resolve installed CLI command; falls back to python -m for dev.""" + import shutil + force = os.environ.get("CLI_ANYTHING_FORCE_INSTALLED", "").strip() == "1" + path = shutil.which(name) + if path: + print(f"[_resolve_cli] Using installed command: {path}") + return [path] + if force: + raise RuntimeError(f"{name} not found in PATH. Install with: pip install -e .") + module = "cli_anything.openclaw.openclaw_cli" + print(f"[_resolve_cli] Falling back to: {sys.executable} -m {module}") + return [sys.executable, "-m", "cli_anything.openclaw"] + + +# ── Helpers ─────────────────────────────────────────────────────────────────── + +def write_macro(tmp_path: Path, name: str, content: str) -> Path: + p = tmp_path / f"{name}.yaml" + p.write_text(content, encoding="utf-8") + return p + + +# ── E2E: File transform workflow ────────────────────────────────────────────── + +class TestFileTransformE2E: + def test_json_set_and_verify(self, tmp_path): + """Write a JSON file, transform it, verify the result.""" + from cli_anything.openclaw.core.macro_model import MacroDefinition, MacroStep, MacroCondition, MacroOutput + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + + json_file = tmp_path / "settings.json" + json_file.write_text('{"version": 1}', encoding="utf-8") + + yaml_content = textwrap.dedent(f"""\ + name: set_json_key + parameters: + file: + type: string + required: true + key: + type: string + required: true + value: + type: string + required: true + preconditions: + - file_exists: ${{file}} + steps: + - id: transform + backend: file_transform + action: json_set + params: + input_file: ${{file}} + output_file: ${{file}} + path: ${{key}} + value: ${{value}} + postconditions: + - file_exists: ${{file}} + outputs: + - name: modified_file + path: ${{file}} + """) + write_macro(tmp_path, "set_json_key", yaml_content) + + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("set_json_key", { + "file": str(json_file), + "key": "config.theme", + "value": "dark", + }) + + assert result.success, f"Failed: {result.error}" + data = json.loads(json_file.read_text()) + assert data["config"]["theme"] == "dark" + print(f"\n Modified JSON: {json_file} → {json.dumps(data)}") + + +class TestNativeAPIE2E: + def test_run_real_command_and_capture(self, tmp_path): + """Run a real shell command and capture its stdout.""" + from cli_anything.openclaw.core.macro_model import MacroDefinition + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + + output_file = tmp_path / "result.txt" + yaml_content = textwrap.dedent(f"""\ + name: capture_date + parameters: + output: + type: string + required: true + steps: + - id: run_date + backend: native_api + action: run_command + params: + command: [date, "+%Y-%m-%d"] + capture_stdout: true + postconditions: [] + outputs: + - name: output_file + path: ${{output}} + """) + write_macro(tmp_path, "capture_date", yaml_content) + + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("capture_date", {"output": str(output_file)}) + + assert result.success, f"Failed: {result.error}" + # Step output contains stdout + steps_output = result.output.get("_steps", []) + assert steps_output, "Expected _steps in output" + stdout = steps_output[0].get("stdout", "") + # Date format YYYY-MM-DD + import re + assert re.match(r"\d{4}-\d{2}-\d{2}", stdout.strip()), f"Unexpected stdout: {stdout!r}" + print(f"\n Captured date: {stdout.strip()}") + + def test_step_failure_aborts_macro(self, tmp_path): + """A failing step with on_failure=fail should abort the macro.""" + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + + yaml_content = textwrap.dedent("""\ + name: fail_abort + steps: + - id: bad + backend: native_api + action: run_command + params: + command: [false] + on_failure: fail + - id: good + backend: native_api + action: run_command + params: + command: [echo, should_not_run] + """) + write_macro(tmp_path, "fail_abort", yaml_content) + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("fail_abort", {}) + + assert not result.success + # Only the first step should have run + assert result.telemetry["steps_run"] == 1 + print(f"\n Correctly aborted after first step: {result.error}") + + def test_step_failure_skip_continues(self, tmp_path): + """A failing step with on_failure=skip should allow the macro to continue.""" + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + + yaml_content = textwrap.dedent("""\ + name: fail_skip + steps: + - id: bad + backend: native_api + action: run_command + params: + command: [false] + on_failure: skip + - id: good + backend: native_api + action: run_command + params: + command: [echo, still_ran] + """) + write_macro(tmp_path, "fail_skip", yaml_content) + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("fail_skip", {}) + + assert result.success + assert result.telemetry["steps_run"] == 2 + print(f"\n Macro succeeded despite skipped step") + + +class TestPostconditionE2E: + def test_postcondition_file_exists_passes(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + + output_file = tmp_path / "output.txt" + yaml_content = textwrap.dedent(f"""\ + name: write_and_verify + parameters: + output: + type: string + required: true + steps: + - id: write + backend: file_transform + action: text_replace + params: + input_file: /dev/null + output_file: ${{output}} + find: "" + replace: "" + postconditions: + - file_exists: ${{output}} + """) + write_macro(tmp_path, "write_and_verify", yaml_content) + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("write_and_verify", {"output": str(output_file)}) + assert result.success, f"Failed: {result.error}" + print(f"\n Output file: {output_file} ({output_file.stat().st_size} bytes)") + + def test_postcondition_file_size_gt(self, tmp_path): + from cli_anything.openclaw.core.registry import MacroRegistry + from cli_anything.openclaw.core.runtime import MacroRuntime + + output_file = tmp_path / "output.txt" + output_file.write_text("x" * 200, encoding="utf-8") + + yaml_content = textwrap.dedent(f"""\ + name: size_check + parameters: + output: + type: string + required: true + steps: + - id: noop + backend: native_api + action: run_command + params: + command: [echo, noop] + postconditions: + - file_size_gt: + - ${{output}} + - 100 + """) + write_macro(tmp_path, "size_check", yaml_content) + reg = MacroRegistry(str(tmp_path)) + rt = MacroRuntime(registry=reg) + result = rt.execute("size_check", {"output": str(output_file)}) + assert result.success, f"Failed: {result.error}" + print(f"\n File size: {output_file.stat().st_size} bytes") + + +# ── CLI subprocess tests ────────────────────────────────────────────────────── + +class TestCLISubprocess: + CLI_BASE = _resolve_cli("cli-anything-openclaw") + + def _run(self, args: list[str], check: bool = True) -> subprocess.CompletedProcess: + return subprocess.run( + self.CLI_BASE + args, + capture_output=True, + text=True, + check=check, + ) + + def test_help(self): + result = self._run(["--help"]) + assert result.returncode == 0 + assert "macro" in result.stdout.lower() + + def test_macro_list_json(self): + result = self._run(["--json", "macro", "list"]) + assert result.returncode == 0 + data = json.loads(result.stdout) + assert isinstance(data, list) + print(f"\n macros: {[m['name'] for m in data]}") + + def test_macro_info_json(self): + # Info on a bundled example macro + result = self._run(["--json", "macro", "info", "export_file"]) + assert result.returncode == 0, f"stderr: {result.stderr}" + data = json.loads(result.stdout) + assert data["name"] == "export_file" + assert "parameters" in data + print(f"\n Macro info: {data['name']} v{data['version']}") + + def test_macro_validate_all(self): + result = self._run(["--json", "macro", "validate"]) + assert result.returncode == 0 + data = json.loads(result.stdout) + assert isinstance(data, dict) + for name, info in data.items(): + assert info["valid"], f"Macro {name} failed: {info['errors']}" + print(f"\n Validated {len(data)} macros, all valid") + + def test_macro_dry_run_json(self): + result = self._run([ + "--json", "--dry-run", + "macro", "run", "export_file", + "--param", "output=/tmp/test_openclaw_e2e.txt", + ]) + assert result.returncode == 0, f"stderr: {result.stderr}" + data = json.loads(result.stdout) + assert data["success"] is True + assert data["telemetry"]["dry_run"] is True + print(f"\n Dry run result: {data['success']}") + + def test_backends_json(self): + result = self._run(["--json", "backends"]) + assert result.returncode == 0 + data = json.loads(result.stdout) + assert "native_api" in data + assert "file_transform" in data + print(f"\n Backends: {list(data.keys())}") + + def test_session_status_json(self): + result = self._run(["--json", "session", "status"]) + assert result.returncode == 0 + data = json.loads(result.stdout) + assert "session_id" in data + print(f"\n Session: {data['session_id']}") + + def test_macro_run_json_transform_workflow(self, tmp_path): + """Full E2E: create a JSON file, run transform_json macro, verify output.""" + json_file = tmp_path / "data.json" + json_file.write_text('{"name": "test"}', encoding="utf-8") + + result = self._run([ + "--json", + "macro", "run", "transform_json", + "--param", f"file={json_file}", + "--param", "key=config.mode", + "--param", "value=production", + ]) + print(f"\n CLI stdout: {result.stdout[:200]}") + print(f" CLI stderr: {result.stderr[:200]}") + + assert result.returncode == 0, f"CLI failed:\n{result.stderr}" + data = json.loads(result.stdout) + assert data["success"] is True, f"Macro failed: {data.get('error')}" + + # Verify file was actually modified + modified = json.loads(json_file.read_text()) + assert modified["config"]["mode"] == "production" + print(f"\n Modified JSON: {modified}") + print(f" File: {json_file} ({json_file.stat().st_size} bytes)") + + def test_unknown_macro_returns_error_json(self): + result = self._run( + ["--json", "macro", "run", "nonexistent_macro_xyz"], + check=False, + ) + assert result.returncode != 0 + data = json.loads(result.stdout) + assert data["success"] is False + assert "error" in data + print(f"\n Error: {data['error']}") diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/utils/__init__.py b/openclaw-skill/agent-harness/cli_anything/openclaw/utils/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/openclaw-skill/agent-harness/cli_anything/openclaw/utils/repl_skin.py b/openclaw-skill/agent-harness/cli_anything/openclaw/utils/repl_skin.py new file mode 100644 index 000000000..c7312348a --- /dev/null +++ b/openclaw-skill/agent-harness/cli_anything/openclaw/utils/repl_skin.py @@ -0,0 +1,521 @@ +"""cli-anything REPL Skin — Unified terminal interface for all CLI harnesses. + +Copy this file into your CLI package at: + cli_anything//utils/repl_skin.py + +Usage: + from cli_anything..utils.repl_skin import ReplSkin + + skin = ReplSkin("shotcut", version="1.0.0") + skin.print_banner() # auto-detects skills/SKILL.md inside the package + prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) + skin.success("Project saved") + skin.error("File not found") + skin.warning("Unsaved changes") + skin.info("Processing 24 clips...") + skin.status("Track 1", "3 clips, 00:02:30") + skin.table(headers, rows) + skin.print_goodbye() +""" + +import os +import sys + +# ── ANSI color codes (no external deps for core styling) ────────────── + +_RESET = "\033[0m" +_BOLD = "\033[1m" +_DIM = "\033[2m" +_ITALIC = "\033[3m" +_UNDERLINE = "\033[4m" + +# Brand colors +_CYAN = "\033[38;5;80m" # cli-anything brand cyan +_CYAN_BG = "\033[48;5;80m" +_WHITE = "\033[97m" +_GRAY = "\033[38;5;245m" +_DARK_GRAY = "\033[38;5;240m" +_LIGHT_GRAY = "\033[38;5;250m" + +# Software accent colors — each software gets a unique accent +_ACCENT_COLORS = { + "gimp": "\033[38;5;214m", # warm orange + "blender": "\033[38;5;208m", # deep orange + "inkscape": "\033[38;5;39m", # bright blue + "audacity": "\033[38;5;33m", # navy blue + "libreoffice": "\033[38;5;40m", # green + "obs_studio": "\033[38;5;55m", # purple + "kdenlive": "\033[38;5;69m", # slate blue + "shotcut": "\033[38;5;35m", # teal green +} +_DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue + +# Status colors +_GREEN = "\033[38;5;78m" +_YELLOW = "\033[38;5;220m" +_RED = "\033[38;5;196m" +_BLUE = "\033[38;5;75m" +_MAGENTA = "\033[38;5;176m" + +# ── Brand icon ──────────────────────────────────────────────────────── + +# The cli-anything icon: a small colored diamond/chevron mark +_ICON = f"{_CYAN}{_BOLD}◆{_RESET}" +_ICON_SMALL = f"{_CYAN}▸{_RESET}" + +# ── Box drawing characters ──────────────────────────────────────────── + +_H_LINE = "─" +_V_LINE = "│" +_TL = "╭" +_TR = "╮" +_BL = "╰" +_BR = "╯" +_T_DOWN = "┬" +_T_UP = "┴" +_T_RIGHT = "├" +_T_LEFT = "┤" +_CROSS = "┼" + + +def _strip_ansi(text: str) -> str: + """Remove ANSI escape codes for length calculation.""" + import re + return re.sub(r"\033\[[^m]*m", "", text) + + +def _visible_len(text: str) -> int: + """Get visible length of text (excluding ANSI codes).""" + return len(_strip_ansi(text)) + + +class ReplSkin: + """Unified REPL skin for cli-anything CLIs. + + Provides consistent branding, prompts, and message formatting + across all CLI harnesses built with the cli-anything methodology. + """ + + def __init__(self, software: str, version: str = "1.0.0", + history_file: str | None = None, skill_path: str | None = None): + """Initialize the REPL skin. + + Args: + software: Software name (e.g., "gimp", "shotcut", "blender"). + version: CLI version string. + history_file: Path for persistent command history. + Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the package's skills/ directory if not provided. + Displayed in banner for AI agents to know where to read skill info. + """ + self.software = software.lower().replace("-", "_") + self.display_name = software.replace("_", " ").title() + self.version = version + + # Auto-detect skill path from package layout: + # cli_anything//utils/repl_skin.py (this file) + # cli_anything//skills/SKILL.md (target) + if skill_path is None: + from pathlib import Path + _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + if _auto.is_file(): + skill_path = str(_auto) + self.skill_path = skill_path + self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) + + # History file + if history_file is None: + from pathlib import Path + hist_dir = Path.home() / f".cli-anything-{self.software}" + hist_dir.mkdir(parents=True, exist_ok=True) + self.history_file = str(hist_dir / "history") + else: + self.history_file = history_file + + # Detect terminal capabilities + self._color = self._detect_color_support() + + def _detect_color_support(self) -> bool: + """Check if terminal supports color.""" + if os.environ.get("NO_COLOR"): + return False + if os.environ.get("CLI_ANYTHING_NO_COLOR"): + return False + if not hasattr(sys.stdout, "isatty"): + return False + return sys.stdout.isatty() + + def _c(self, code: str, text: str) -> str: + """Apply color code if colors are supported.""" + if not self._color: + return text + return f"{code}{text}{_RESET}" + + # ── Banner ──────────────────────────────────────────────────────── + + def print_banner(self): + """Print the startup banner with branding.""" + inner = 54 + + def _box_line(content: str) -> str: + """Wrap content in box drawing, padding to inner width.""" + pad = inner - _visible_len(content) + vl = self._c(_DARK_GRAY, _V_LINE) + return f"{vl}{content}{' ' * max(0, pad)}{vl}" + + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") + bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") + + # Title: ◆ cli-anything · Shotcut + icon = self._c(_CYAN + _BOLD, "◆") + brand = self._c(_CYAN + _BOLD, "cli-anything") + dot = self._c(_DARK_GRAY, "·") + name = self._c(self.accent + _BOLD, self.display_name) + title = f" {icon} {brand} {dot} {name}" + + ver = f" {self._c(_DARK_GRAY, f' v{self.version}')}" + tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" + empty = "" + + # Skill path for agent discovery + skill_line = None + if self.skill_path: + skill_icon = self._c(_MAGENTA, "◇") + skill_label = self._c(_DARK_GRAY, " Skill:") + skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) + skill_line = f" {skill_icon} {skill_label} {skill_path_display}" + + print(top) + print(_box_line(title)) + print(_box_line(ver)) + if skill_line: + print(_box_line(skill_line)) + print(_box_line(empty)) + print(_box_line(tip)) + print(bot) + print() + + # ── Prompt ──────────────────────────────────────────────────────── + + def prompt(self, project_name: str = "", modified: bool = False, + context: str = "") -> str: + """Build a styled prompt string for prompt_toolkit or input(). + + Args: + project_name: Current project name (empty if none open). + modified: Whether the project has unsaved changes. + context: Optional extra context to show in prompt. + + Returns: + Formatted prompt string. + """ + parts = [] + + # Icon + if self._color: + parts.append(f"{_CYAN}◆{_RESET} ") + else: + parts.append("> ") + + # Software name + parts.append(self._c(self.accent + _BOLD, self.software)) + + # Project context + if project_name or context: + ctx = context or project_name + mod = "*" if modified else "" + parts.append(f" {self._c(_DARK_GRAY, '[')}") + parts.append(self._c(_LIGHT_GRAY, f"{ctx}{mod}")) + parts.append(self._c(_DARK_GRAY, ']')) + + parts.append(self._c(_GRAY, " ❯ ")) + + return "".join(parts) + + def prompt_tokens(self, project_name: str = "", modified: bool = False, + context: str = ""): + """Build prompt_toolkit formatted text tokens for the prompt. + + Use with prompt_toolkit's FormattedText for proper ANSI handling. + + Returns: + list of (style, text) tuples for prompt_toolkit. + """ + accent_hex = _ANSI_256_TO_HEX.get(self.accent, "#5fafff") + tokens = [] + + tokens.append(("class:icon", "◆ ")) + tokens.append(("class:software", self.software)) + + if project_name or context: + ctx = context or project_name + mod = "*" if modified else "" + tokens.append(("class:bracket", " [")) + tokens.append(("class:context", f"{ctx}{mod}")) + tokens.append(("class:bracket", "]")) + + tokens.append(("class:arrow", " ❯ ")) + + return tokens + + def get_prompt_style(self): + """Get a prompt_toolkit Style object matching the skin. + + Returns: + prompt_toolkit.styles.Style + """ + try: + from prompt_toolkit.styles import Style + except ImportError: + return None + + accent_hex = _ANSI_256_TO_HEX.get(self.accent, "#5fafff") + + return Style.from_dict({ + "icon": "#5fdfdf bold", # cyan brand color + "software": f"{accent_hex} bold", + "bracket": "#585858", + "context": "#bcbcbc", + "arrow": "#808080", + # Completion menu + "completion-menu.completion": "bg:#303030 #bcbcbc", + "completion-menu.completion.current": f"bg:{accent_hex} #000000", + "completion-menu.meta.completion": "bg:#303030 #808080", + "completion-menu.meta.completion.current": f"bg:{accent_hex} #000000", + # Auto-suggest + "auto-suggest": "#585858", + # Bottom toolbar + "bottom-toolbar": "bg:#1c1c1c #808080", + "bottom-toolbar.text": "#808080", + }) + + # ── Messages ────────────────────────────────────────────────────── + + def success(self, message: str): + """Print a success message with green checkmark.""" + icon = self._c(_GREEN + _BOLD, "✓") + print(f" {icon} {self._c(_GREEN, message)}") + + def error(self, message: str): + """Print an error message with red cross.""" + icon = self._c(_RED + _BOLD, "✗") + print(f" {icon} {self._c(_RED, message)}", file=sys.stderr) + + def warning(self, message: str): + """Print a warning message with yellow triangle.""" + icon = self._c(_YELLOW + _BOLD, "⚠") + print(f" {icon} {self._c(_YELLOW, message)}") + + def info(self, message: str): + """Print an info message with blue dot.""" + icon = self._c(_BLUE, "●") + print(f" {icon} {self._c(_LIGHT_GRAY, message)}") + + def hint(self, message: str): + """Print a subtle hint message.""" + print(f" {self._c(_DARK_GRAY, message)}") + + def section(self, title: str): + """Print a section header.""" + print() + print(f" {self._c(self.accent + _BOLD, title)}") + print(f" {self._c(_DARK_GRAY, _H_LINE * len(title))}") + + # ── Status display ──────────────────────────────────────────────── + + def status(self, label: str, value: str): + """Print a key-value status line.""" + lbl = self._c(_GRAY, f" {label}:") + val = self._c(_WHITE, f" {value}") + print(f"{lbl}{val}") + + def status_block(self, items: dict[str, str], title: str = ""): + """Print a block of status key-value pairs. + + Args: + items: Dict of label -> value pairs. + title: Optional title for the block. + """ + if title: + self.section(title) + + max_key = max(len(k) for k in items) if items else 0 + for label, value in items.items(): + lbl = self._c(_GRAY, f" {label:<{max_key}}") + val = self._c(_WHITE, f" {value}") + print(f"{lbl}{val}") + + def progress(self, current: int, total: int, label: str = ""): + """Print a simple progress indicator. + + Args: + current: Current step number. + total: Total number of steps. + label: Optional label for the progress. + """ + pct = int(current / total * 100) if total > 0 else 0 + bar_width = 20 + filled = int(bar_width * current / total) if total > 0 else 0 + bar = "█" * filled + "░" * (bar_width - filled) + text = f" {self._c(_CYAN, bar)} {self._c(_GRAY, f'{pct:3d}%')}" + if label: + text += f" {self._c(_LIGHT_GRAY, label)}" + print(text) + + # ── Table display ───────────────────────────────────────────────── + + def table(self, headers: list[str], rows: list[list[str]], + max_col_width: int = 40): + """Print a formatted table with box-drawing characters. + + Args: + headers: Column header strings. + rows: List of rows, each a list of cell strings. + max_col_width: Maximum column width before truncation. + """ + if not headers: + return + + # Calculate column widths + col_widths = [min(len(h), max_col_width) for h in headers] + for row in rows: + for i, cell in enumerate(row): + if i < len(col_widths): + col_widths[i] = min( + max(col_widths[i], len(str(cell))), max_col_width + ) + + def pad(text: str, width: int) -> str: + t = str(text)[:width] + return t + " " * (width - len(t)) + + # Header + header_cells = [ + self._c(_CYAN + _BOLD, pad(h, col_widths[i])) + for i, h in enumerate(headers) + ] + sep = self._c(_DARK_GRAY, f" {_V_LINE} ") + header_line = f" {sep.join(header_cells)}" + print(header_line) + + # Separator + sep_parts = [self._c(_DARK_GRAY, _H_LINE * w) for w in col_widths] + sep_line = self._c(_DARK_GRAY, f" {'───'.join([_H_LINE * w for w in col_widths])}") + print(sep_line) + + # Rows + for row in rows: + cells = [] + for i, cell in enumerate(row): + if i < len(col_widths): + cells.append(self._c(_LIGHT_GRAY, pad(str(cell), col_widths[i]))) + row_sep = self._c(_DARK_GRAY, f" {_V_LINE} ") + print(f" {row_sep.join(cells)}") + + # ── Help display ────────────────────────────────────────────────── + + def help(self, commands: dict[str, str]): + """Print a formatted help listing. + + Args: + commands: Dict of command -> description pairs. + """ + self.section("Commands") + max_cmd = max(len(c) for c in commands) if commands else 0 + for cmd, desc in commands.items(): + cmd_styled = self._c(self.accent, f" {cmd:<{max_cmd}}") + desc_styled = self._c(_GRAY, f" {desc}") + print(f"{cmd_styled}{desc_styled}") + print() + + # ── Goodbye ─────────────────────────────────────────────────────── + + def print_goodbye(self): + """Print a styled goodbye message.""" + print(f"\n {_ICON_SMALL} {self._c(_GRAY, 'Goodbye!')}\n") + + # ── Prompt toolkit session factory ──────────────────────────────── + + def create_prompt_session(self): + """Create a prompt_toolkit PromptSession with skin styling. + + Returns: + A configured PromptSession, or None if prompt_toolkit unavailable. + """ + try: + from prompt_toolkit import PromptSession + from prompt_toolkit.history import FileHistory + from prompt_toolkit.auto_suggest import AutoSuggestFromHistory + from prompt_toolkit.formatted_text import FormattedText + + style = self.get_prompt_style() + + session = PromptSession( + history=FileHistory(self.history_file), + auto_suggest=AutoSuggestFromHistory(), + style=style, + enable_history_search=True, + ) + return session + except ImportError: + return None + + def get_input(self, pt_session, project_name: str = "", + modified: bool = False, context: str = "") -> str: + """Get input from user using prompt_toolkit or fallback. + + Args: + pt_session: A prompt_toolkit PromptSession (or None). + project_name: Current project name. + modified: Whether project has unsaved changes. + context: Optional context string. + + Returns: + User input string (stripped). + """ + if pt_session is not None: + from prompt_toolkit.formatted_text import FormattedText + tokens = self.prompt_tokens(project_name, modified, context) + return pt_session.prompt(FormattedText(tokens)).strip() + else: + raw_prompt = self.prompt(project_name, modified, context) + return input(raw_prompt).strip() + + # ── Toolbar builder ─────────────────────────────────────────────── + + def bottom_toolbar(self, items: dict[str, str]): + """Create a bottom toolbar callback for prompt_toolkit. + + Args: + items: Dict of label -> value pairs to show in toolbar. + + Returns: + A callable that returns FormattedText for the toolbar. + """ + def toolbar(): + from prompt_toolkit.formatted_text import FormattedText + parts = [] + for i, (k, v) in enumerate(items.items()): + if i > 0: + parts.append(("class:bottom-toolbar.text", " │ ")) + parts.append(("class:bottom-toolbar.text", f" {k}: ")) + parts.append(("class:bottom-toolbar", v)) + return FormattedText(parts) + return toolbar + + +# ── ANSI 256-color to hex mapping (for prompt_toolkit styles) ───────── + +_ANSI_256_TO_HEX = { + "\033[38;5;33m": "#0087ff", # audacity navy blue + "\033[38;5;35m": "#00af5f", # shotcut teal + "\033[38;5;39m": "#00afff", # inkscape bright blue + "\033[38;5;40m": "#00d700", # libreoffice green + "\033[38;5;55m": "#5f00af", # obs purple + "\033[38;5;69m": "#5f87ff", # kdenlive slate blue + "\033[38;5;75m": "#5fafff", # default sky blue + "\033[38;5;80m": "#5fd7d7", # brand cyan + "\033[38;5;208m": "#ff8700", # blender deep orange + "\033[38;5;214m": "#ffaf00", # gimp warm orange +} diff --git a/openclaw-skill/agent-harness/setup.py b/openclaw-skill/agent-harness/setup.py new file mode 100644 index 000000000..69c962550 --- /dev/null +++ b/openclaw-skill/agent-harness/setup.py @@ -0,0 +1,58 @@ +#!/usr/bin/env python3 +""" +setup.py for cli-anything-openclaw + +Install with: pip install -e . +""" + +from setuptools import setup, find_namespace_packages + +with open("cli_anything/openclaw/README.md", "r", encoding="utf-8") as fh: + long_description = fh.read() + +setup( + name="cli-anything-openclaw", + version="1.0.0", + author="cli-anything contributors", + author_email="", + description=( + "OpenClaw Macro System — A layered CLI that converts GUI workflows into " + "parameterized, agent-callable macros. Requires: PyYAML, click, prompt-toolkit." + ), + long_description=long_description, + long_description_content_type="text/markdown", + url="https://github.com/HKUDS/CLI-Anything", + packages=find_namespace_packages(include=["cli_anything.*"]), + classifiers=[ + "Development Status :: 4 - Beta", + "Intended Audience :: Developers", + "Topic :: Software Development :: Libraries :: Python Modules", + "License :: OSI Approved :: MIT License", + "Programming Language :: Python :: 3", + "Programming Language :: Python :: 3.10", + "Programming Language :: Python :: 3.11", + "Programming Language :: Python :: 3.12", + ], + python_requires=">=3.10", + install_requires=[ + "click>=8.0.0", + "prompt-toolkit>=3.0.0", + "PyYAML>=6.0", + ], + extras_require={ + "dev": [ + "pytest>=7.0.0", + "pytest-cov>=4.0.0", + ], + }, + entry_points={ + "console_scripts": [ + "cli-anything-openclaw=cli_anything.openclaw.openclaw_cli:cli", + ], + }, + package_data={ + "cli_anything.openclaw": ["skills/*.md", "macro_definitions/*.yaml", "macro_definitions/examples/*.yaml"], + }, + include_package_data=True, + zip_safe=False, +) diff --git a/openscreen/agent-harness/cli_anything/openscreen/utils/repl_skin.py b/openscreen/agent-harness/cli_anything/openscreen/utils/repl_skin.py index 2feb59d1b..bc1fb6d1d 100644 --- a/openscreen/agent-harness/cli_anything/openscreen/utils/repl_skin.py +++ b/openscreen/agent-harness/cli_anything/openscreen/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -459,26 +528,6 @@ class ReplSkin: raw_prompt = self.prompt(project_name, modified, context) return input(raw_prompt).strip() - # ── Sub-prompt input ──────────────────────────────────────────── - - def sub_input(self, prompt_text: str, pt_session=None) -> str: - """Get input for a sub-prompt (e.g., parameter entry in add flows). - - Uses prompt_toolkit if a session is available, otherwise falls back - to plain input(). This preserves history and styling consistency. - - Args: - prompt_text: The prompt to display (e.g., " start_ms: "). - pt_session: An optional prompt_toolkit PromptSession. - - Returns: - User input string (stripped). - """ - if pt_session is not None: - return pt_session.prompt(prompt_text).strip() - else: - return input(prompt_text).strip() - # ── Toolbar builder ─────────────────────────────────────────────── def bottom_toolbar(self, items: dict[str, str]): diff --git a/pm2/agent-harness/cli_anything/pm2/utils/repl_skin.py b/pm2/agent-harness/cli_anything/pm2/utils/repl_skin.py index b356cb835..bc1fb6d1d 100644 --- a/pm2/agent-harness/cli_anything/pm2/utils/repl_skin.py +++ b/pm2/agent-harness/cli_anything/pm2/utils/repl_skin.py @@ -6,20 +6,21 @@ Copy this file into your CLI package at: Usage: from cli_anything..utils.repl_skin import ReplSkin - skin = ReplSkin("ollama", version="1.0.0") - skin.print_banner() - prompt_text = skin.prompt(project_name="llama3.2", modified=False) - skin.success("Model pulled") - skin.error("Connection failed") - skin.warning("No models loaded") - skin.info("Generating...") - skin.status("Model", "llama3.2:latest") + skin = ReplSkin("shotcut", version="1.0.0") + skin.print_banner() # auto-detects repo-root or packaged SKILL.md + prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) + skin.success("Project saved") + skin.error("File not found") + skin.warning("Unsaved changes") + skin.info("Processing 24 clips...") + skin.status("Track 1", "3 clips, 00:02:30") skin.table(headers, rows) skin.print_goodbye() """ import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "ollama": "\033[38;5;255m", # white (Ollama branding) } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -98,23 +111,53 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: - software: Software name (e.g., "gimp", "shotcut", "ollama"). + software: Software name (e.g., "gimp", "shotcut", "blender"). version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -144,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -152,10 +197,28 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") - # Title: ◆ cli-anything · Ollama + # Title: ◆ cli-anything · Shotcut icon = self._c(_CYAN + _BOLD, "◆") brand = self._c(_CYAN + _BOLD, "cli-anything") dot = self._c(_DARK_GRAY, "·") @@ -166,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -496,5 +564,4 @@ _ANSI_256_TO_HEX = { "\033[38;5;80m": "#5fd7d7", # brand cyan "\033[38;5;208m": "#ff8700", # blender deep orange "\033[38;5;214m": "#ffaf00", # gimp warm orange - "\033[38;5;255m": "#eeeeee", # ollama white } diff --git a/public_registry.json b/public_registry.json index 2bcaa8998..118f3cc2c 100644 --- a/public_registry.json +++ b/public_registry.json @@ -2,7 +2,7 @@ "meta": { "repo": "https://github.com/HKUDS/CLI-Anything", "description": "Public CLI Registry — Third-party and official CLIs managed by CLI-Hub across npm, bundled, brew, and other install methods", - "updated": "2026-04-16" + "updated": "2026-04-18" }, "clis": [ { @@ -18,6 +18,7 @@ "npm_package": "@larksuite/cli", "install_cmd": "npm install -g @larksuite/cli", "npx_cmd": "npx @larksuite/cli", + "skill_md": "npx skills add larksuite/cli -y -g", "entry_point": "lark-cli", "contributors": [ { @@ -39,6 +40,7 @@ "npm_package": "minimax-cli", "install_cmd": "npm install -g minimax-cli", "npx_cmd": "npx minimax-cli", + "skill_md": "https://platform.minimax.io/docs/token-plan/minimax-cli", "entry_point": "minimax-cli", "contributors": [ { @@ -60,6 +62,7 @@ "npm_package": "@wecom/cli", "install_cmd": "npm install -g @wecom/cli", "npx_cmd": "npx @wecom/cli", + "skill_md": "npx skills add WeComTeam/wecom-cli -y -g", "entry_point": "wecom-cli", "contributors": [ { @@ -81,6 +84,7 @@ "npm_package": "contentful-cli", "install_cmd": "npm install -g contentful-cli", "npx_cmd": "npx contentful-cli", + "skill_md": "https://github.com/contentful/contentful-cli/tree/main/docs", "entry_point": "contentful", "contributors": [ { @@ -102,6 +106,7 @@ "npm_package": "sanity", "install_cmd": "npm install -g sanity", "npx_cmd": "npx sanity@latest", + "skill_md": "https://www.sanity.io/docs/apis-and-sdks/cli", "entry_point": "sanity", "contributors": [ { @@ -123,6 +128,7 @@ "npm_package": "@shopify/cli", "install_cmd": "npm install -g @shopify/cli", "npx_cmd": "npx @shopify/cli@latest", + "skill_md": "https://github.com/Shopify/cli/blob/main/packages/cli/README.md#commands", "entry_point": "shopify", "contributors": [ { @@ -144,6 +150,7 @@ "npm_package": "@sentry/cli", "install_cmd": "npm install -g @sentry/cli", "npx_cmd": "npx @sentry/cli", + "skill_md": "https://docs.sentry.io/cli/", "entry_point": "sentry-cli", "contributors": [ { @@ -166,6 +173,7 @@ "install_cmd": "brew install --cask 1password-cli", "uninstall_cmd": "brew uninstall --cask 1password-cli", "update_cmd": "brew upgrade --cask 1password-cli", + "skill_md": "https://developer.1password.com/docs/cli/get-started/", "entry_point": "op", "contributors": [ { @@ -174,6 +182,31 @@ } ] }, + { + "name": "android-cli", + "display_name": "Android CLI", + "version": "0.7", + "description": "Official Android terminal interface for SDK setup, project creation, emulator/device management, app run/deploy workflows, docs access, and skill management for any agent", + "category": "mobile", + "requires": "Preview release; Linux x86_64, macOS arm64, or Windows x86_64. Android SDK / JDK requirements depend on the workflow you run.", + "homepage": "https://developer.android.com/tools/agents/android-cli", + "docs_url": "https://android-developers.googleblog.com/2026/04/build-android-apps-3x-faster-using-any-agent.html", + "source_url": null, + "package_manager": "bundled", + "install_strategy": "bundled", + "install_notes": "Install Android CLI from the official archive page: Linux `curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash`; macOS `curl -fsSL https://dl.google.com/android/cli/latest/darwin_arm64/install.sh | bash`; Windows `curl.exe -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o \"%TEMP%\\i.cmd\" && \"%TEMP%\\i.cmd\"`.", + "uninstall_notes": "Remove the Android CLI binary from your PATH or rerun the official installer cleanup flow for your platform.", + "update_notes": "Run `android update` to fetch the latest Android CLI capabilities, or reinstall from the official archive page if needed.", + "skill_md": "https://developer.android.com/tools/agents/android-skills", + "entry_point": "android", + "detect_cmd": "android", + "contributors": [ + { + "name": "Android Developers", + "url": "https://developer.android.com" + } + ] + }, { "name": "generate-veo-video", "display_name": "Generate Veo Video", @@ -187,6 +220,7 @@ "install_cmd": "uv tool install git+https://github.com/charles-forsyth/generate-veo-video.git", "uninstall_cmd": "uv tool uninstall generate-veo-video", "update_cmd": "uv tool upgrade generate-veo-video", + "skill_md": "https://github.com/charles-forsyth/generate-veo-video", "entry_point": "generate-veo", "contributors": [ { @@ -195,6 +229,51 @@ } ] }, + { + "name": "suno", + "display_name": "Suno CLI", + "version": "latest", + "description": "CLI for generating music with Suno AI from lyrics and style prompts, with batch generation, status polling, downloads, and automatic MP3 tagging", + "category": "music", + "requires": "Python 3 and a Suno API key from sunoapi.org", + "homepage": "https://github.com/slauger/suno-cli", + "source_url": "https://github.com/slauger/suno-cli", + "package_manager": "pip", + "install_strategy": "command", + "install_cmd": "python3 -m pip install git+https://github.com/slauger/suno-cli.git", + "uninstall_cmd": "python3 -m pip uninstall -y suno-cli", + "update_cmd": "python3 -m pip install --upgrade --force-reinstall git+https://github.com/slauger/suno-cli.git", + "skill_md": "https://github.com/slauger/suno-cli/blob/main/docs/USAGE.md", + "entry_point": "suno", + "contributors": [ + { + "name": "slauger", + "url": "https://github.com/slauger" + } + ] + }, + { + "name": "elevenlabs", + "display_name": "ElevenLabs CLI", + "version": "latest", + "description": "Official ElevenLabs CLI for managing voice agents as code with local configs, templates, auth, push/pull sync, tests, widgets, and branch-aware workflows", + "category": "audio", + "requires": "Node.js and npm, ELEVENLABS_API_KEY or interactive login", + "homepage": "https://github.com/elevenlabs/cli", + "source_url": "https://github.com/elevenlabs/cli", + "package_manager": "npm", + "npm_package": "@elevenlabs/cli", + "install_cmd": "npm install -g @elevenlabs/cli", + "npx_cmd": "npx @elevenlabs/cli@latest", + "skill_md": "https://github.com/elevenlabs/cli", + "entry_point": "elevenlabs", + "contributors": [ + { + "name": "ElevenLabs", + "url": "https://github.com/elevenlabs" + } + ] + }, { "name": "jimeng", "display_name": "Jimeng / Dreamina CLI", @@ -208,6 +287,7 @@ "package_manager": "script", "install_strategy": "command", "install_cmd": "curl -s https://jimeng.jianying.com/cli | bash", + "skill_md": "https://bytedance.larkoffice.com/wiki/FVTwwm0bGiishxkKOoScdHR2nsg", "entry_point": "dreamina", "contributors": [ { @@ -230,6 +310,7 @@ "install_notes": "Bundled within the Obsidian 1.12+ installer. Enable Command line interface in Obsidian settings and follow the registration prompt so `obsidian` is added to PATH.", "uninstall_notes": "Disable Command line interface from Obsidian settings or remove/update the Obsidian installer to stop using the bundled CLI.", "update_notes": "Update the Obsidian installer to a newer 1.12+ release to update the bundled CLI.", + "skill_md": "https://obsidian.md/help/cli", "entry_point": "obsidian", "detect_cmd": "obsidian", "contributors": [ @@ -238,6 +319,26 @@ "url": "https://obsidian.md" } ] + }, + { + "name": "py4csr", + "display_name": "TraceCSR / Py4CSR CLI", + "version": "latest", + "description": "GxP-compliant agent harness for CDISC Clinical Study Report (CSR) and Tables/Figures/Listings (TFL) generation", + "category": "data-science", + "requires": "Python >= 3.10", + "homepage": "https://github.com/yanmingyu92/py4csr", + "source_url": "https://github.com/yanmingyu92/py4csr", + "skill_md": "https://github.com/yanmingyu92/py4csr", + "package_manager": "pip", + "install_cmd": "pip install py4csr", + "entry_point": "tracecsr", + "contributors": [ + { + "name": "yanmingyu92", + "url": "https://github.com/yanmingyu92" + } + ] } ] } diff --git a/registry.json b/registry.json index 4e84bf89a..d6d9ab4ea 100644 --- a/registry.json +++ b/registry.json @@ -15,7 +15,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=wiremock/agent-harness", "entry_point": "cli-anything-wiremock", - "skill_md": "wiremock/agent-harness/cli_anything/wiremock/skills/SKILL.md", + "skill_md": "skills/cli-anything-wiremock/SKILL.md", "category": "testing", "contributors": [ { @@ -34,7 +34,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=anygen/agent-harness", "entry_point": "cli-anything-anygen", - "skill_md": "anygen/agent-harness/cli_anything/anygen/skills/SKILL.md", + "skill_md": "skills/cli-anything-anygen/SKILL.md", "category": "generation", "contributors": [ { @@ -72,7 +72,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=audacity/agent-harness", "entry_point": "cli-anything-audacity", - "skill_md": "audacity/agent-harness/cli_anything/audacity/skills/SKILL.md", + "skill_md": "skills/cli-anything-audacity/SKILL.md", "category": "audio", "contributors": [ { @@ -91,7 +91,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=blender/agent-harness", "entry_point": "cli-anything-blender", - "skill_md": "blender/agent-harness/cli_anything/blender/skills/SKILL.md", + "skill_md": "skills/cli-anything-blender/SKILL.md", "category": "3d", "contributors": [ { @@ -110,7 +110,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=browser/agent-harness", "entry_point": "cli-anything-browser", - "skill_md": "browser/agent-harness/cli_anything/browser/skills/SKILL.md", + "skill_md": "skills/cli-anything-browser/SKILL.md", "category": "web", "contributors": [ { @@ -148,7 +148,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=drawio/agent-harness", "entry_point": "cli-anything-drawio", - "skill_md": "drawio/agent-harness/cli_anything/drawio/skills/SKILL.md", + "skill_md": "skills/cli-anything-drawio/SKILL.md", "category": "diagrams", "contributors": [ { @@ -167,7 +167,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=eth2-quickstart/agent-harness", "entry_point": "cli-anything-eth2-quickstart", - "skill_md": "eth2-quickstart/agent-harness/cli_anything/eth2_quickstart/skills/SKILL.md", + "skill_md": "skills/cli-anything-eth2-quickstart/SKILL.md", "category": "devops", "contributors": [ { @@ -186,7 +186,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=gimp/agent-harness", "entry_point": "cli-anything-gimp", - "skill_md": "gimp/agent-harness/cli_anything/gimp/skills/SKILL.md", + "skill_md": "skills/cli-anything-gimp/SKILL.md", "category": "image", "contributors": [ { @@ -205,7 +205,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=inkscape/agent-harness", "entry_point": "cli-anything-inkscape", - "skill_md": "inkscape/agent-harness/cli_anything/inkscape/skills/SKILL.md", + "skill_md": "skills/cli-anything-inkscape/SKILL.md", "category": "image", "contributors": [ { @@ -224,7 +224,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=kdenlive/agent-harness", "entry_point": "cli-anything-kdenlive", - "skill_md": "kdenlive/agent-harness/cli_anything/kdenlive/skills/SKILL.md", + "skill_md": "skills/cli-anything-kdenlive/SKILL.md", "category": "video", "contributors": [ { @@ -243,7 +243,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=krita/agent-harness", "entry_point": "cli-anything-krita", - "skill_md": "krita/agent-harness/cli_anything/krita/skills/SKILL.md", + "skill_md": "skills/cli-anything-krita/SKILL.md", "category": "image", "contributors": [ { @@ -262,7 +262,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=libreoffice/agent-harness", "entry_point": "cli-anything-libreoffice", - "skill_md": "libreoffice/agent-harness/cli_anything/libreoffice/skills/SKILL.md", + "skill_md": "skills/cli-anything-libreoffice/SKILL.md", "category": "office", "contributors": [ { @@ -323,7 +323,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=mubu/agent-harness", "entry_point": "cli-anything-mubu", - "skill_md": "mubu/agent-harness/cli_anything/mubu/skills/SKILL.md", + "skill_md": "skills/cli-anything-mubu/SKILL.md", "category": "office", "contributors": [ { @@ -361,7 +361,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=notebooklm/agent-harness", "entry_point": "cli-anything-notebooklm", - "skill_md": "notebooklm/agent-harness/cli_anything/notebooklm/skills/SKILL.md", + "skill_md": "skills/cli-anything-notebooklm/SKILL.md", "category": "ai", "contributors": [ { @@ -380,7 +380,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=ollama/agent-harness", "entry_point": "cli-anything-ollama", - "skill_md": "ollama/agent-harness/cli_anything/ollama/skills/SKILL.md", + "skill_md": "skills/cli-anything-ollama/SKILL.md", "category": "ai", "contributors": [ { @@ -399,7 +399,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=obs-studio/agent-harness", "entry_point": "cli-anything-obs-studio", - "skill_md": "obs-studio/agent-harness/cli_anything/obs_studio/skills/SKILL.md", + "skill_md": "skills/cli-anything-obs-studio/SKILL.md", "category": "streaming", "contributors": [ { @@ -418,7 +418,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=shotcut/agent-harness", "entry_point": "cli-anything-shotcut", - "skill_md": "shotcut/agent-harness/cli_anything/shotcut/skills/SKILL.md", + "skill_md": "skills/cli-anything-shotcut/SKILL.md", "category": "video", "contributors": [ { @@ -437,7 +437,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=openscreen/agent-harness", "entry_point": "cli-anything-openscreen", - "skill_md": "openscreen/agent-harness/cli_anything/openscreen/skills/SKILL.md", + "skill_md": "skills/cli-anything-openscreen/SKILL.md", "category": "video", "contributors": [ { @@ -456,7 +456,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=zoom/agent-harness", "entry_point": "cli-anything-zoom", - "skill_md": "zoom/agent-harness/cli_anything/zoom/skills/SKILL.md", + "skill_md": "skills/cli-anything-zoom/SKILL.md", "category": "communication", "contributors": [ { @@ -475,7 +475,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=novita/agent-harness", "entry_point": "cli-anything-novita", - "skill_md": "novita/agent-harness/cli_anything/novita/skills/SKILL.md", + "skill_md": "skills/cli-anything-novita/SKILL.md", "category": "ai", "contributors": [ { @@ -494,7 +494,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=seaclip/agent-harness", "entry_point": "cli-anything-seaclip", - "skill_md": "seaclip/agent-harness/cli_anything/seaclip/skills/SKILL.md", + "skill_md": "skills/cli-anything-seaclip/SKILL.md", "category": "project-management", "contributors": [ { @@ -513,7 +513,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=pm2/agent-harness", "entry_point": "cli-anything-pm2", - "skill_md": "pm2/agent-harness/cli_anything/pm2/skills/SKILL.md", + "skill_md": "skills/cli-anything-pm2/SKILL.md", "category": "devops", "contributors": [ { @@ -546,7 +546,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=chromadb/agent-harness", "entry_point": "cli-anything-chromadb", - "skill_md": "chromadb/agent-harness/cli_anything/chromadb/skills/SKILL.md", + "skill_md": "skills/cli-anything-chromadb/SKILL.md", "category": "database", "contributors": [ { @@ -565,7 +565,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=musescore/agent-harness", "entry_point": "cli-anything-musescore", - "skill_md": "musescore/agent-harness/cli_anything/musescore/skills/SKILL.md", + "skill_md": "skills/cli-anything-musescore/SKILL.md", "category": "music", "contributors": [ { @@ -603,7 +603,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=freecad/agent-harness", "entry_point": "cli-anything-freecad", - "skill_md": "freecad/agent-harness/cli_anything/freecad/skills/SKILL.md", + "skill_md": "skills/cli-anything-freecad/SKILL.md", "category": "3d", "contributors": [ { @@ -622,7 +622,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=iterm2/agent-harness", "entry_point": "cli-anything-iterm2", - "skill_md": "iterm2/agent-harness/cli_anything/iterm2_ctl/skills/SKILL.md", + "skill_md": "skills/cli-anything-iterm2/SKILL.md", "category": "devops", "contributors": [ { @@ -641,7 +641,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=slay_the_spire_ii/agent-harness", "entry_point": "cli-anything-sts2", - "skill_md": "slay_the_spire_ii/agent-harness/cli_anything/slay_the_spire_ii/skills/SKILL.md", + "skill_md": "skills/cli-anything-slay-the-spire-ii/SKILL.md", "category": "game", "contributors": [ { @@ -660,7 +660,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=rms/agent-harness", "entry_point": "cli-anything-rms", - "skill_md": "rms/agent-harness/cli_anything/rms/skills/SKILL.md", + "skill_md": "skills/cli-anything-rms/SKILL.md", "category": "network", "contributors": [ { @@ -679,7 +679,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=renderdoc/agent-harness", "entry_point": "cli-anything-renderdoc", - "skill_md": "renderdoc/agent-harness/cli_anything/renderdoc/skills/SKILL.md", + "skill_md": "skills/cli-anything-renderdoc/SKILL.md", "category": "graphics", "contributors": [ { @@ -698,7 +698,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=videocaptioner/agent-harness", "entry_point": "cli-anything-videocaptioner", - "skill_md": "videocaptioner/agent-harness/cli_anything/videocaptioner/skills/SKILL.md", + "skill_md": "skills/cli-anything-videocaptioner/SKILL.md", "category": "video", "contributors": [ { @@ -717,7 +717,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=intelwatch/agent-harness", "entry_point": "cli-anything-intelwatch", - "skill_md": "intelwatch/agent-harness/cli_anything/intelwatch/skills/SKILL.md", + "skill_md": "skills/cli-anything-intelwatch/SKILL.md", "category": "osint", "contributors": [ { @@ -755,7 +755,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=cloudcompare/agent-harness", "entry_point": "cli-anything-cloudcompare", - "skill_md": "cloudcompare/agent-harness/cli_anything/cloudcompare/skills/SKILL.md", + "skill_md": "skills/cli-anything-cloudcompare/SKILL.md", "category": "graphics", "contributors": [ { @@ -774,7 +774,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=exa/agent-harness", "entry_point": "cli-anything-exa", - "skill_md": "exa/agent-harness/cli_anything/exa/skills/SKILL.md", + "skill_md": "skills/cli-anything-exa/SKILL.md", "category": "search", "contributors": [ { @@ -793,7 +793,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness", "entry_point": "cli-anything-godot", - "skill_md": "godot/agent-harness/cli_anything/godot/skills/SKILL.md", + "skill_md": "skills/cli-anything-godot/SKILL.md", "category": "gamedev", "contributors": [ { @@ -812,7 +812,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=dify-workflow/agent-harness", "entry_point": "cli-anything-dify-workflow", - "skill_md": "dify-workflow/agent-harness/cli_anything/dify_workflow/skills/SKILL.md", + "skill_md": "skills/cli-anything-dify-workflow/SKILL.md", "category": "ai", "contributors": [ { @@ -831,7 +831,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=n8n/agent-harness", "entry_point": "cli-anything-n8n", - "skill_md": "n8n/agent-harness/cli_anything/n8n/skills/SKILL.md", + "skill_md": "skills/cli-anything-n8n/SKILL.md", "category": "automation", "contributors": [ { @@ -850,7 +850,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=cloudanalyzer/agent-harness", "entry_point": "cli-anything-cloudanalyzer", - "skill_md": "cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.md", + "skill_md": "skills/cli-anything-cloudanalyzer/SKILL.md", "category": "graphics", "contributors": [ { @@ -869,7 +869,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=obsidian/agent-harness", "entry_point": "cli-anything-obsidian", - "skill_md": "obsidian/agent-harness/cli_anything/obsidian/skills/SKILL.md", + "skill_md": "skills/cli-anything-obsidian/SKILL.md", "category": "knowledge", "contributors": [ { @@ -888,7 +888,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=unimol_tools/agent-harness", "entry_point": "cli-anything-unimol-tools", - "skill_md": "unimol_tools/agent-harness/cli_anything/unimol_tools/SKILL.md", + "skill_md": "skills/cli-anything-unimol-tools/SKILL.md", "category": "science", "contributors": [ { @@ -907,7 +907,7 @@ "source_url": null, "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=safari/agent-harness", "entry_point": "cli-anything-safari", - "skill_md": "safari/agent-harness/cli_anything/safari/skills/SKILL.md", + "skill_md": "skills/cli-anything-safari/SKILL.md", "category": "web", "contributors": [ { @@ -915,6 +915,25 @@ "url": "https://github.com/achiya-automation" } ] + }, + { + "name": "openclaw-macro", + "display_name": "OpenClaw Macro System", + "version": "1.0.0", + "description": "Layered CLI that converts GUI workflows into parameterized, agent-callable macros — with backend routing across native APIs, file transforms, accessibility controls, and compiled GUI replay", + "requires": null, + "homepage": "https://github.com/HKUDS/CLI-Anything", + "source_url": null, + "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=openclaw-skill/agent-harness", + "entry_point": "cli-anything-openclaw", + "skill_md": "openclaw-skill/agent-harness/cli_anything/openclaw/skills/SKILL.md", + "category": "automation", + "contributors": [ + { + "name": "haorui-harry", + "url": "https://github.com/haorui-harry" + } + ] } ] } diff --git a/renderdoc/agent-harness/cli_anything/renderdoc/utils/repl_skin.py b/renderdoc/agent-harness/cli_anything/renderdoc/utils/repl_skin.py index c7312348a..bc1fb6d1d 100644 --- a/renderdoc/agent-harness/cli_anything/renderdoc/utils/repl_skin.py +++ b/renderdoc/agent-harness/cli_anything/renderdoc/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -106,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -156,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -164,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -178,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/rms/agent-harness/cli_anything/rms/utils/repl_skin.py b/rms/agent-harness/cli_anything/rms/utils/repl_skin.py index 75ac09b1b..bc1fb6d1d 100644 --- a/rms/agent-harness/cli_anything/rms/utils/repl_skin.py +++ b/rms/agent-harness/cli_anything/rms/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,9 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "anygen": "\033[38;5;141m", # soft violet - "novita": "\033[38;5;81m", # vivid blue (for Novita AI) - "rms": "\033[38;5;27m", # Teltonika blue } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -60,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -92,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -109,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -159,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -167,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -181,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/safari/agent-harness/cli_anything/safari/utils/repl_skin.py b/safari/agent-harness/cli_anything/safari/utils/repl_skin.py index 44b4dcfb8..bc1fb6d1d 100644 --- a/safari/agent-harness/cli_anything/safari/utils/repl_skin.py +++ b/safari/agent-harness/cli_anything/safari/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() # auto-detects skills/SKILL.md inside the package + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "safari": "\033[38;5;33m", # Safari blue } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -107,27 +120,44 @@ class ReplSkin: history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history skill_path: Path to the SKILL.md file for agent discovery. - Auto-detected from the package's skills/ directory if not provided. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") - # Auto-detect skill path from package layout: - # cli_anything//utils/repl_skin.py (this file) - # cli_anything//skills/SKILL.md (target) + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. if skill_path is None: - from pathlib import Path - _auto = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" - if _auto.is_file(): - skill_path = str(_auto) + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -157,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -165,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -179,19 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" - # Skill path for agent discovery - skill_line = None - if self.skill_path: - skill_icon = self._c(_MAGENTA, "◇") - skill_label = self._c(_DARK_GRAY, " Skill:") - skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) - skill_line = f" {skill_icon} {skill_label} {skill_path_display}" - + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) - if skill_line: - print(_box_line(skill_line)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/seaclip/agent-harness/cli_anything/seaclip/utils/repl_skin.py b/seaclip/agent-harness/cli_anything/seaclip/utils/repl_skin.py index b356cb835..bc1fb6d1d 100644 --- a/seaclip/agent-harness/cli_anything/seaclip/utils/repl_skin.py +++ b/seaclip/agent-harness/cli_anything/seaclip/utils/repl_skin.py @@ -6,20 +6,21 @@ Copy this file into your CLI package at: Usage: from cli_anything..utils.repl_skin import ReplSkin - skin = ReplSkin("ollama", version="1.0.0") - skin.print_banner() - prompt_text = skin.prompt(project_name="llama3.2", modified=False) - skin.success("Model pulled") - skin.error("Connection failed") - skin.warning("No models loaded") - skin.info("Generating...") - skin.status("Model", "llama3.2:latest") + skin = ReplSkin("shotcut", version="1.0.0") + skin.print_banner() # auto-detects repo-root or packaged SKILL.md + prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) + skin.success("Project saved") + skin.error("File not found") + skin.warning("Unsaved changes") + skin.info("Processing 24 clips...") + skin.status("Track 1", "3 clips, 00:02:30") skin.table(headers, rows) skin.print_goodbye() """ import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -47,7 +48,6 @@ _ACCENT_COLORS = { "obs_studio": "\033[38;5;55m", # purple "kdenlive": "\033[38;5;69m", # slate blue "shotcut": "\033[38;5;35m", # teal green - "ollama": "\033[38;5;255m", # white (Ollama branding) } _DEFAULT_ACCENT = "\033[38;5;75m" # default sky blue @@ -58,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -90,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -98,23 +111,53 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: - software: Software name (e.g., "gimp", "shotcut", "ollama"). + software: Software name (e.g., "gimp", "shotcut", "blender"). version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -144,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -152,10 +197,28 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") - # Title: ◆ cli-anything · Ollama + # Title: ◆ cli-anything · Shotcut icon = self._c(_CYAN + _BOLD, "◆") brand = self._c(_CYAN + _BOLD, "cli-anything") dot = self._c(_DARK_GRAY, "·") @@ -166,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) @@ -496,5 +564,4 @@ _ANSI_256_TO_HEX = { "\033[38;5;80m": "#5fd7d7", # brand cyan "\033[38;5;208m": "#ff8700", # blender deep orange "\033[38;5;214m": "#ffaf00", # gimp warm orange - "\033[38;5;255m": "#eeeeee", # ollama white } diff --git a/shotcut/agent-harness/.gitignore b/shotcut/agent-harness/.gitignore new file mode 100644 index 000000000..e458ed577 --- /dev/null +++ b/shotcut/agent-harness/.gitignore @@ -0,0 +1 @@ +.worktrees/ diff --git a/shotcut/agent-harness/cli_anything/shotcut/core/export.py b/shotcut/agent-harness/cli_anything/shotcut/core/export.py index d396a1c65..610fe861a 100644 --- a/shotcut/agent-harness/cli_anything/shotcut/core/export.py +++ b/shotcut/agent-harness/cli_anything/shotcut/core/export.py @@ -6,6 +6,7 @@ import shutil from typing import Optional from ..utils import mlt_xml +from ..utils.time import timecode_to_frames, frames_to_timecode from .session import Session @@ -411,6 +412,57 @@ def render(session: Session, output_path: str, width, height) +def _set_tractor_out(session: Session) -> None: + """Set tractor out= to actual timeline duration before passing to melt. + + The tractor is created with out="00:00:00.000" and never updated as clips + are added. Without this fix, melt falls back to the longest track in the + multitrack — the 4-hour black background — and renders a 4-hour file. + """ + profile = session.get_profile() + fps_num = int(profile.get("frame_rate_num", 30000)) + fps_den = int(profile.get("frame_rate_den", 1001)) + + tractor = mlt_xml.get_main_tractor(session.root) + if tractor is None: + return + + tracks = mlt_xml.get_tractor_tracks(tractor) + max_frames = 0 + for te in tracks: + prod_id = te.get("producer", "") + if prod_id == "background": + continue + playlist = mlt_xml.find_element_by_id(session.root, prod_id) + if playlist is None: + continue + total = 0 + for child in playlist: + if child.tag == "entry": + in_f = timecode_to_frames(child.get("in", "0"), fps_num, fps_den) + out_f = timecode_to_frames(child.get("out", "0"), fps_num, fps_den) + total += max(0, out_f - in_f + 1) + elif child.tag == "blank": + try: + total += timecode_to_frames(child.get("length", "0"), fps_num, fps_den) + except Exception: + pass + max_frames = max(max_frames, total) + + if max_frames > 0: + out_tc = frames_to_timecode(max_frames - 1, fps_num, fps_den) + tractor.set("out", out_tc) + # Cap the background track to the same duration so melt doesn't + # extend the render to the 4-hour background default. + bg_playlist = mlt_xml.find_element_by_id(session.root, "background") + if bg_playlist is not None: + for entry in bg_playlist.findall("entry"): + entry.set("out", out_tc) + black_producer = session.root.find(".//producer[@id='black']") + if black_producer is not None: + black_producer.set("out", out_tc) + + def _render_with_melt(session: Session, output_path: str, preset: dict, melt_path: str, width: Optional[int], height: Optional[int], @@ -418,6 +470,10 @@ def _render_with_melt(session: Session, output_path: str, """Render using melt command.""" import tempfile + # Fix tractor out before rendering — without this melt renders the full + # 4-hour background track instead of the actual content duration. + _set_tractor_out(session) + # Save project to temp file with tempfile.NamedTemporaryFile(suffix=".mlt", delete=False, mode="w") as f: temp_mlt = f.name diff --git a/shotcut/agent-harness/cli_anything/shotcut/tests/test_core.py b/shotcut/agent-harness/cli_anything/shotcut/tests/test_core.py index 4ed8fc144..14ff6c180 100644 --- a/shotcut/agent-harness/cli_anything/shotcut/tests/test_core.py +++ b/shotcut/agent-harness/cli_anything/shotcut/tests/test_core.py @@ -25,8 +25,10 @@ from cli_anything.shotcut.utils.mlt_xml import ( create_blank_project, mlt_to_string, parse_mlt, write_mlt, get_property, set_property, get_main_tractor, get_tractor_tracks, get_all_producers, get_playlist_entries, find_element_by_id, - add_filter_to_element, + add_filter_to_element, add_track_to_tractor, add_entry_to_playlist, + add_blank_to_playlist, ) +from cli_anything.shotcut.utils.time import frames_to_timecode as _ftc # ============================================================================ @@ -689,6 +691,70 @@ class TestExport: finally: os.unlink(tmpfile) + def test_set_tractor_out_single_clip(self): + """_set_tractor_out sets tractor out to match a single clip duration.""" + s = Session() + proj_mod.new_project(s, "hd1080p30") + tractor = get_main_tractor(s.root) + playlist_id, _ = add_track_to_tractor(s.root, tractor, "video", "V1") + playlist = find_element_by_id(s.root, playlist_id) + + # Add a 6-second clip (frames 0–179 at 29.97fps ≈ 180 frames) + prod = s.root.makeelement("producer", {"id": "clip1"}) + s.root.insert(0, prod) + add_entry_to_playlist(playlist, "clip1", "00:00:00.000", "00:00:05.999") + + # Before fix: tractor out is still the initial value + assert tractor.get("out") == "00:00:00.000" + + export_mod._set_tractor_out(s) + + # After fix: tractor out should reflect the clip duration + assert tractor.get("out") != "00:00:00.000" + assert tractor.get("out") != "04:00:00.000" + # Background entry should be capped too + bg = find_element_by_id(s.root, "background") + bg_entry = bg.find("entry") + assert bg_entry.get("out") == tractor.get("out") + # Black producer should be capped + black = s.root.find(".//producer[@id='black']") + assert black.get("out") == tractor.get("out") + + def test_set_tractor_out_multi_segment(self): + """_set_tractor_out sums entry spans and blanks across segments.""" + s = Session() + proj_mod.new_project(s, "hd1080p30") + tractor = get_main_tractor(s.root) + pid, _ = add_track_to_tractor(s.root, tractor, "video", "V1") + playlist = find_element_by_id(s.root, pid) + + # Two 3-second clips with a 1-second blank between + prod1 = s.root.makeelement("producer", {"id": "seg1"}) + prod2 = s.root.makeelement("producer", {"id": "seg2"}) + s.root.insert(0, prod1) + s.root.insert(0, prod2) + add_entry_to_playlist(playlist, "seg1", "00:00:00.000", "00:00:02.999") + add_blank_to_playlist(playlist, "00:00:01.000") + add_entry_to_playlist(playlist, "seg2", "00:00:00.000", "00:00:02.999") + + export_mod._set_tractor_out(s) + + # Tractor out should cover all segments + blank (~7 seconds) + out_tc = tractor.get("out") + assert out_tc != "00:00:00.000" + assert out_tc != "04:00:00.000" + + def test_set_tractor_out_empty_timeline(self): + """_set_tractor_out is a no-op on a blank project with no clips.""" + s = Session() + proj_mod.new_project(s, "hd1080p30") + tractor = get_main_tractor(s.root) + + export_mod._set_tractor_out(s) + + # No clips → tractor out should stay unchanged + assert tractor.get("out") == "00:00:00.000" + # ============================================================================ # Integration: full workflow diff --git a/shotcut/agent-harness/cli_anything/shotcut/utils/repl_skin.py b/shotcut/agent-harness/cli_anything/shotcut/utils/repl_skin.py index 47260bebd..bc1fb6d1d 100644 --- a/shotcut/agent-harness/cli_anything/shotcut/utils/repl_skin.py +++ b/shotcut/agent-harness/cli_anything/shotcut/utils/repl_skin.py @@ -7,7 +7,7 @@ Usage: from cli_anything..utils.repl_skin import ReplSkin skin = ReplSkin("shotcut", version="1.0.0") - skin.print_banner() + skin.print_banner() # auto-detects repo-root or packaged SKILL.md prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") skin.error("File not found") @@ -20,6 +20,7 @@ Usage: import os import sys +from pathlib import Path # ── ANSI color codes (no external deps for core styling) ────────────── @@ -57,6 +58,8 @@ _RED = "\033[38;5;196m" _BLUE = "\033[38;5;75m" _MAGENTA = "\033[38;5;176m" +_SKILL_SOURCE_REPO = os.environ.get("CLI_ANYTHING_SKILL_REPO", "HKUDS/CLI-Anything") + # ── Brand icon ──────────────────────────────────────────────────────── # The cli-anything icon: a small colored diamond/chevron mark @@ -89,6 +92,17 @@ def _visible_len(text: str) -> int: return len(_strip_ansi(text)) +def _display_home_path(path: str) -> str: + """Display a path relative to the home directory when possible.""" + expanded = Path(path).expanduser().resolve() + home = Path.home().resolve() + try: + relative = expanded.relative_to(home) + return f"~/{relative.as_posix()}" + except ValueError: + return str(expanded) + + class ReplSkin: """Unified REPL skin for cli-anything CLIs. @@ -97,7 +111,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,15 +119,45 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Auto-detected from the repo-root skills/ tree when present, + otherwise from the package's skills/ directory. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + software_aliases = {"iterm2_ctl": "iterm2"} + self.skill_slug = software_aliases.get(self.software, self.software).replace("_", "-") + self.skill_id = f"cli-anything-{self.skill_slug}" + self.skill_install_cmd = ( + f"npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y" + ) + global_skill_root = Path( + os.environ.get("CLI_ANYTHING_GLOBAL_SKILLS_DIR", str(Path.home() / ".agents" / "skills")) + ).expanduser() + self.global_skill_path = str(global_skill_root / self.skill_id / "SKILL.md") + + # Prefer repo-root canonical skills//SKILL.md when running + # inside the CLI-Anything monorepo. Fall back to the packaged + # cli_anything//skills/SKILL.md for installed harnesses. + if skill_path is None: + package_skill = Path(__file__).resolve().parent.parent / "skills" / "SKILL.md" + repo_skill = None + for parent in Path(__file__).resolve().parents: + candidate = parent / "skills" / self.skill_id / "SKILL.md" + if candidate.is_file(): + repo_skill = candidate + break + if repo_skill and repo_skill.is_file(): + skill_path = str(repo_skill) + elif package_skill.is_file(): + skill_path = str(package_skill) + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file if history_file is None: - from pathlib import Path hist_dir = Path.home() / f".cli-anything-{self.software}" hist_dir.mkdir(parents=True, exist_ok=True) self.history_file = str(hist_dir / "history") @@ -143,7 +187,9 @@ class ReplSkin: def print_banner(self): """Print the startup banner with branding.""" - inner = 54 + import textwrap + + inner = 72 def _box_line(content: str) -> str: """Wrap content in box drawing, padding to inner width.""" @@ -151,6 +197,24 @@ class ReplSkin: vl = self._c(_DARK_GRAY, _V_LINE) return f"{vl}{content}{' ' * max(0, pad)}{vl}" + def _meta_lines(label: str, value: str) -> list[str]: + """Wrap a metadata line for the banner box.""" + icon = self._c(_MAGENTA, "◇") + label_text = self._c(_DARK_GRAY, label) + prefix = f" {icon} {label_text} " + available = max(12, inner - _visible_len(prefix)) + wrapped = textwrap.wrap( + value, + width=available, + break_long_words=True, + break_on_hyphens=False, + ) or [""] + lines = [f"{prefix}{self._c(_LIGHT_GRAY, wrapped[0])}"] + continuation_prefix = " " * _visible_len(prefix) + for chunk in wrapped[1:]: + lines.append(f"{continuation_prefix}{self._c(_LIGHT_GRAY, chunk)}") + return lines + top = self._c(_DARK_GRAY, f"{_TL}{_H_LINE * inner}{_TR}") bot = self._c(_DARK_GRAY, f"{_BL}{_H_LINE * inner}{_BR}") @@ -165,9 +229,14 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + meta_lines: list[str] = [] + meta_lines.extend(_meta_lines("Install:", self.skill_install_cmd)) + meta_lines.extend(_meta_lines("Global skill:", _display_home_path(self.global_skill_path))) print(top) print(_box_line(title)) print(_box_line(ver)) + for line in meta_lines: + print(_box_line(line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/skills/README.md b/skills/README.md new file mode 100644 index 000000000..6f347acc0 --- /dev/null +++ b/skills/README.md @@ -0,0 +1,31 @@ +# CLI-Anything Skills + +This directory is the canonical `npx skills` surface for in-repo CLI-Anything +harnesses. + +Layout: + +```text +skills/ + cli-anything-audacity/SKILL.md + cli-anything-blender/SKILL.md + ... +``` + +Typical usage: + +```bash +npx skills add HKUDS/CLI-Anything --list +npx skills add HKUDS/CLI-Anything --skill cli-anything-audacity -g -y +``` + +The `SKILL.md` files here are the canonical repo-root copies. Installed harness +packages still ship compatibility copies inside `cli_anything//skills/` +for local runtime discovery. + +CI rule: + +- If a harness keeps a deep packaged `SKILL.md`, it must also have a matching + repo-root `skills//SKILL.md`. +- A future harness that only defines its canonical skill directly in `skills/` + is also valid. diff --git a/skills/cli-anything-adguardhome/SKILL.md b/skills/cli-anything-adguardhome/SKILL.md new file mode 100644 index 000000000..7e3891840 --- /dev/null +++ b/skills/cli-anything-adguardhome/SKILL.md @@ -0,0 +1,255 @@ +--- +name: "cli-anything-adguardhome" +description: >- + Command-line interface for AdGuard Home - Network-wide ad blocking and DNS management via AdGuard Home REST API. Designed for AI agents and power users who need to manage filtering, DNS rewrites, clients, DHCP, and query logs without a GUI. +--- + +# cli-anything-adguardhome + +Network-wide ad blocking and DNS management via the AdGuard Home REST API. Designed for AI agents and power users who need to manage filtering, DNS rewrites, clients, DHCP, and query logs without a GUI. + +## Installation + +This CLI is installed as part of the cli-anything-adguardhome package: + +```bash +pip install cli-anything-adguardhome +``` + +**Prerequisites:** +- Python 3.10+ +- AdGuard Home must be installed and running +- Install AdGuard Home: `curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v` + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-adguardhome --help + +# Start interactive REPL mode +cli-anything-adguardhome + +# Check server status +cli-anything-adguardhome server status + +# Run with JSON output (for agent consumption) +cli-anything-adguardhome --json server status +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-adguardhome +# Enter commands interactively with tab-completion and history +``` + +## Command Groups + +### Config + +Connection and configuration management. + +| Command | Description | +|---------|-------------| +| `show` | Show current connection configuration | +| `save` | Save connection settings to a config file | +| `test` | Test the connection to AdGuard Home | + +### Server + +Server status and control commands. + +| Command | Description | +|---------|-------------| +| `status` | Show server protection status | +| `version` | Show AdGuard Home version | +| `restart` | Restart the AdGuard Home server | + +### Filter + +DNS filter list management. + +| Command | Description | +|---------|-------------| +| `list` | List all configured filter lists | +| `status` | Show filtering status | +| `toggle` | Enable or disable filtering globally | +| `add` | Add a new filter list by URL | +| `remove` | Remove a filter list | +| `enable` | Enable a specific filter list | +| `disable` | Disable a specific filter list | +| `refresh` | Force-refresh all filter lists | + +### Blocking + +Parental control, safe browsing, and safe search settings. + +| Command | Description | +|---------|-------------| +| `parental status` | Show parental control status | +| `parental enable` | Enable parental control | +| `parental disable` | Disable parental control | +| `safebrowsing status` | Show safe browsing status | +| `safebrowsing enable` | Enable safe browsing | +| `safebrowsing disable` | Disable safe browsing | +| `safesearch status` | Show safe search status | +| `safesearch enable` | Enable safe search | +| `safesearch disable` | Disable safe search | + +### Blocked-Services + +Manage blocked internet services. + +| Command | Description | +|---------|-------------| +| `list` | List currently blocked services | +| `set` | Set the list of blocked services | + +### Clients + +Client device management. + +| Command | Description | +|---------|-------------| +| `list` | List all configured clients | +| `add` | Add a new client by name and IP | +| `remove` | Remove a client | +| `show` | Show details for a specific client | + +### Stats + +Query statistics. + +| Command | Description | +|---------|-------------| +| `show` | Show DNS query statistics | +| `reset` | Reset all statistics | +| `config` | View or update statistics retention interval | + +### Log + +DNS query log management. + +| Command | Description | +|---------|-------------| +| `show` | Show recent DNS query log entries | +| `config` | View or update query log settings | +| `clear` | Clear the query log | + +### Rewrite + +DNS rewrite rules. + +| Command | Description | +|---------|-------------| +| `list` | List all DNS rewrite rules | +| `add` | Add a DNS rewrite rule | +| `remove` | Remove a DNS rewrite rule | + +### DHCP + +DHCP server management. + +| Command | Description | +|---------|-------------| +| `status` | Show DHCP server status | +| `leases` | List active DHCP leases | +| `add-static` | Add a static DHCP lease | +| `remove-static` | Remove a static DHCP lease | + +### TLS + +TLS/HTTPS configuration. + +| Command | Description | +|---------|-------------| +| `status` | Show TLS configuration status | + +## Examples + +### Check Server Status + +```bash +cli-anything-adguardhome server status +cli-anything-adguardhome server version +``` + +### Manage Filter Lists + +```bash +# List current filters +cli-anything-adguardhome filter list + +# Add a new blocklist +cli-anything-adguardhome filter add --url https://somehost.com/list.txt --name "My List" + +# Refresh all filters +cli-anything-adguardhome filter refresh +``` + +### DNS Rewrites + +```bash +# Add a local DNS entry +cli-anything-adguardhome rewrite add --domain "myserver.local" --answer "192.168.1.50" + +# List all rewrites +cli-anything-adguardhome rewrite list +``` + +### Client Management + +```bash +cli-anything-adguardhome clients add --name "My PC" --ip 192.168.1.100 +cli-anything-adguardhome clients list +``` + +### Query Statistics + +```bash +# Show stats (human-readable) +cli-anything-adguardhome stats show + +# Show stats (JSON for agents) +cli-anything-adguardhome --json stats show +``` + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-adguardhome filter list + +# JSON output for agents +cli-anything-adguardhome --json filter list +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Test connection first** with `config test` before other commands + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 diff --git a/skills/cli-anything-anygen/SKILL.md b/skills/cli-anything-anygen/SKILL.md new file mode 100644 index 000000000..8b56514d1 --- /dev/null +++ b/skills/cli-anything-anygen/SKILL.md @@ -0,0 +1,173 @@ +--- +name: "cli-anything-anygen" +description: >- + Command-line interface for Anygen - A stateful command-line interface for AnyGen OpenAPI — generate professional slides, documents, webs... +--- + +# cli-anything-anygen + +A stateful command-line interface for AnyGen OpenAPI — generate professional slides, documents, websites, diagrams, and more from natural language prompts. Designed for AI agents and power users. + +## Installation + +This CLI is installed as part of the cli-anything-anygen package: + +```bash +pip install cli-anything-anygen +``` + +**Prerequisites:** +- Python 3.10+ +- anygen must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-anygen --help + +# Start interactive REPL mode +cli-anything-anygen + +# Create a new project +cli-anything-anygen project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-anygen --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-anygen +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Task + +Task management — create, poll, download, and run tasks. + +| Command | Description | +|---------|-------------| +| `create` | Create a generation task | +| `status` | Query task status (non-blocking) | +| `poll` | Poll task until completion (blocking) | +| `download` | Download the generated file for a completed task | +| `thumbnail` | Download thumbnail image for a completed task | +| `run` | Full workflow: create, poll, download | +| `list` | List locally cached task records | +| `prepare` | Multi-turn requirement analysis before creating a task | + + +### File + +File operations — upload reference files. + +| Command | Description | +|---------|-------------| +| `upload` | Upload a reference file to get a file_token | + + +### Config + +Configuration management — API key and settings. + +| Command | Description | +|---------|-------------| +| `set` | Set a configuration value | +| `get` | Get a configuration value (or show all) | +| `delete` | Delete a configuration value | +| `path` | Show the config file path | + + +### Session + +Session management — history, undo, redo. + +| Command | Description | +|---------|-------------| +| `status` | Show session status | +| `history` | Show command history | +| `undo` | Undo last command | +| `redo` | Redo last undone command | + + + + +## Examples + + +### Create a New Project + +Create a new anygen project file. + +```bash +cli-anything-anygen project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-anygen --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-anygen +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-anygen project info -p project.json + +# JSON output for agents +cli-anything-anygen --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/skills/cli-anything-audacity/SKILL.md b/skills/cli-anything-audacity/SKILL.md new file mode 100644 index 000000000..ffae46f7c --- /dev/null +++ b/skills/cli-anything-audacity/SKILL.md @@ -0,0 +1,244 @@ +--- +name: "cli-anything-audacity" +description: >- + Command-line interface for Audacity - A stateful command-line interface for audio editing, following the same patterns as the GIMP and Ble... +--- + +# cli-anything-audacity + +A stateful command-line interface for audio editing, following the same patterns as the GIMP and Blender CLIs in this repo. + +## Installation + +This CLI is installed as part of the cli-anything-audacity package: + +```bash +pip install cli-anything-audacity +``` + +**Prerequisites:** +- Python 3.10+ +- audacity must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-audacity --help + +# Start interactive REPL mode +cli-anything-audacity + +# Create a new project +cli-anything-audacity project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-audacity --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-audacity +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management commands. + +| Command | Description | +|---------|-------------| +| `new` | Create a new project | +| `open` | Open an existing project | +| `save` | Save the current project | +| `info` | Show project information | +| `settings` | View or update project settings | +| `json` | Print raw project JSON | + + +### Track + +Track management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a new track | +| `remove` | Remove a track by index | +| `list` | List all tracks | +| `set` | Set a track property (name, mute, solo, volume, pan) | + + +### Clip + +Clip management commands. + +| Command | Description | +|---------|-------------| +| `import` | Probe/import an audio file (show metadata) | +| `add` | Add an audio clip to a track | +| `remove` | Remove a clip from a track | +| `trim` | Trim a clip's start and/or end | +| `split` | Split a clip at a given time position | +| `move` | Move a clip to a new start time | +| `list` | List clips on a track | + + +### Effect Group + +Effect management commands. + +| Command | Description | +|---------|-------------| +| `list-available` | List all available effects | +| `info` | Show details about an effect | +| `add` | Add an effect to a track | +| `remove` | Remove an effect by index | +| `set` | Set an effect parameter | +| `list` | List effects on a track | + + +### Selection + +Selection management commands. + +| Command | Description | +|---------|-------------| +| `set` | Set selection range | +| `all` | Select all (entire project duration) | +| `none` | Clear selection | +| `info` | Show current selection | + + +### Label + +Label/marker management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a label at a time position | +| `remove` | Remove a label by index | +| `list` | List all labels | + + +### Media + +Media file operations. + +| Command | Description | +|---------|-------------| +| `probe` | Analyze an audio file | +| `check` | Check that all referenced audio files exist | + + +### Export Group + +Export/render commands. + +| Command | Description | +|---------|-------------| +| `presets` | List export presets | +| `preset-info` | Show preset details | +| `render` | Render the project to an audio file | + + +### Session Group + +Session management commands. + +| Command | Description | +|---------|-------------| +| `status` | Show session status | +| `undo` | Undo the last operation | +| `redo` | Redo the last undone operation | +| `history` | Show undo history | + + + + +## Examples + + +### Create a New Project + +Create a new audacity project file. + +```bash +cli-anything-audacity project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-audacity --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-audacity +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-audacity --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-audacity project info -p project.json + +# JSON output for agents +cli-anything-audacity --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/skills/cli-anything-blender/SKILL.md b/skills/cli-anything-blender/SKILL.md new file mode 100644 index 000000000..b4a3c1422 --- /dev/null +++ b/skills/cli-anything-blender/SKILL.md @@ -0,0 +1,241 @@ +--- +name: "cli-anything-blender" +description: >- + Command-line interface for Blender - A stateful command-line interface for 3D scene editing, following the same patterns as the GIMP CLI ... +--- + +# cli-anything-blender + +A stateful command-line interface for 3D scene editing, following the same patterns as the GIMP CLI harness. Uses a JSON scene description format with bpy script generation for actual Blender rendering. + +## Installation + +This CLI is installed as part of the cli-anything-blender package: + +```bash +pip install cli-anything-blender +``` + +**Prerequisites:** +- Python 3.10+ +- blender (>= 4.2) must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-blender --help + +# Start interactive REPL mode +cli-anything-blender + +# Create a new project +cli-anything-blender project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-blender --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-blender +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Scene + +Scene management commands. + +| Command | Description | +|---------|-------------| +| `new` | Create a new scene | +| `open` | Open an existing scene | +| `save` | Save the current scene | +| `info` | Show scene information | +| `profiles` | List available scene profiles | +| `json` | Print raw scene JSON | + + +### Object Group + +3D object management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a 3D primitive object | +| `remove` | Remove an object by index | +| `duplicate` | Duplicate an object | +| `transform` | Transform an object (translate, rotate, scale) | +| `set` | Set an object property (name, visible, location, rotation, scale, parent) | +| `list` | List all objects | +| `get` | Get detailed info about an object | + + +### Material + +Material management commands. + +| Command | Description | +|---------|-------------| +| `create` | Create a new material | +| `assign` | Assign a material to an object | +| `set` | Set a material property (color, metallic, roughness, specular, alpha, etc.) | +| `list` | List all materials | +| `get` | Get detailed info about a material | + + +### Modifier Group + +Modifier management commands. + +| Command | Description | +|---------|-------------| +| `list-available` | List all available modifiers | +| `info` | Show details about a modifier | +| `add` | Add a modifier to an object | +| `remove` | Remove a modifier by index | +| `set` | Set a modifier parameter | +| `list` | List modifiers on an object | + + +### Camera + +Camera management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a camera to the scene | +| `set` | Set a camera property | +| `set-active` | Set the active camera | +| `list` | List all cameras | + + +### Light + +Light management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a light to the scene | +| `set` | Set a light property | +| `list` | List all lights | + + +### Animation + +Animation and keyframe commands. + +| Command | Description | +|---------|-------------| +| `keyframe` | Set a keyframe on an object | +| `remove-keyframe` | Remove a keyframe from an object | +| `frame-range` | Set the animation frame range | +| `fps` | Set the animation FPS | +| `list-keyframes` | List keyframes for an object | + + +### Render Group + +Render settings and output commands. + +| Command | Description | +|---------|-------------| +| `settings` | Configure render settings | +| `info` | Show current render settings | +| `presets` | List available render presets | +| `execute` | Render the scene (generates bpy script) | +| `script` | Generate bpy script without rendering | + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| +| `status` | Show session status | +| `undo` | Undo the last operation | +| `redo` | Redo the last undone operation | +| `history` | Show undo history | + + + + +## Examples + + +### Create a New Project + +Create a new blender project file. + +```bash +cli-anything-blender project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-blender --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-blender +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-blender project info -p project.json + +# JSON output for agents +cli-anything-blender --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **MANDATORY: Use absolute paths** for all file operations (rendering, project files). Relative paths are prone to failure in background execution. +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/skills/cli-anything-browser/SKILL.md b/skills/cli-anything-browser/SKILL.md new file mode 100644 index 000000000..73b9e4d4a --- /dev/null +++ b/skills/cli-anything-browser/SKILL.md @@ -0,0 +1,213 @@ +--- +name: "cli-anything-browser" +description: "Browser automation CLI using DOMShell MCP server. Maps Chrome's Accessibility Tree to a virtual filesystem for agent-native navigation." +--- + +# cli-anything-browser + +A command-line interface for browser automation using [DOMShell](https://github.com/apireno/DOMShell)'s MCP server. Navigate web pages using filesystem commands: `ls`, `cd`, `cat`, `grep`, `click`. + +## Installation + +### Prerequisites + +1. **Node.js and npx** (for DOMShell MCP server): + ```bash + # Install Node.js from https://nodejs.org/ + npx --version + ``` + +2. **Chrome/Chromium** with [DOMShell extension](https://chromewebstore.google.com/detail/domshell-browser-filesy/okcliheamhmijccjknkkplploacoidnp): + - Install extension in Chrome + - Ensure Chrome is running before using CLI + +3. **Python 3.10+** + +### Install CLI + +```bash +cd browser/agent-harness +pip install -e . +``` + +## Command Groups + +### `page` — Page Navigation + +- `page open ` — Navigate to URL +- `page reload` — Reload current page +- `page back` — Navigate back in history +- `page forward` — Navigate forward in history +- `page info` — Show current page info + +### `fs` — Filesystem Commands (Accessibility Tree) + +- `fs ls [path]` — List elements at path +- `fs cd ` — Change directory +- `fs cat [path]` — Read element content +- `fs grep [path]` — Search for text pattern +- `fs pwd` — Print working directory + +### `act` — Action Commands + +- `act click ` — Click an element +- `act type ` — Type text into input + +### `session` — Session Management + +- `session status` — Show session state +- `session daemon-start` — Start persistent daemon mode +- `session daemon-stop` — Stop daemon mode + +## Usage Examples + +### Basic Navigation + +```bash +# Open a page +cli-anything-browser page open https://example.com + +# Explore structure +cli-anything-browser fs ls / +cli-anything-browser fs cd /main +cli-anything-browser fs ls + +# Go back to root +cli-anything-browser fs cd / +``` + +### Search and Click + +```bash +cli-anything-browser fs grep "Login" +cli-anything-browser act click /main/button[0] +``` + +### Form Fill + +```bash +cli-anything-browser act type /main/input[0] "user@example.com" +cli-anything-browser act click /main/button[0] +``` + +### JSON Output + +```bash +cli-anything-browser --json fs ls / +``` + +### Daemon Mode (Faster Interactive Use) + +```bash +# Start persistent connection +cli-anything-browser session daemon-start + +# Run commands (uses persistent connection) +cli-anything-browser fs ls / +cli-anything-browser fs cd /main + +# Stop daemon when done +cli-anything-browser session daemon-stop +``` + +### Interactive REPL + +```bash +cli-anything-browser +``` + +## Path Syntax + +DOMShell uses a filesystem-like path for the Accessibility Tree: + +``` +/ — Root (document) +/main — Main landmark +/main/div[0] — First div in main +/main/div[0]/button[2] — Third button in first div +``` + +- Array indices are **0-based**: `button[0]` is the first button +- Use `..` to go up one level +- Use `/` for root + +## Agent-Specific Guidance + +### JSON Output for Parsing + +All commands support `--json` flag for machine-readable output: + +```bash +cli-anything-browser --json fs ls / +``` + +Returns: +```json +{ + "path": "/", + "entries": [ + {"name": "main", "role": "landmark", "path": "/main"} + ] +} +``` + +### Error Handling + +The CLI provides clear error messages for common issues: + +- **npx not found**: Install Node.js from https://nodejs.org/ +- **DOMShell not found**: Run `npx @apireno/domshell --version` +- **MCP call failed**: Install DOMShell Chrome extension + +Check `is_available()` return value before running commands. + +### Daemon Mode for Efficiency + +For agent workflows with multiple commands, use daemon mode: + +1. Start daemon: `cli-anything-browser session daemon-start` +2. Run commands: Each command reuses the MCP connection +3. Stop daemon: `cli-anything-browser session daemon-stop` + +This avoids the 1-3 second cold start overhead for each command. + +## Links + +- [DOMShell GitHub](https://github.com/apireno/DOMShell) +- [CLI-Anything](https://github.com/HKUDS/CLI-Anything) +- [Issue #90](https://github.com/HKUDS/CLI-Anything/issues/90) + +## Security Considerations + +**IMPORTANT**: When using this CLI with AI agents, be aware of the following security considerations: + +### URL Restrictions +The browser harness validates all URLs before navigation: +- **Explicit scheme required**: URLs must include `http://` or `https://` scheme (scheme-less URLs like `example.com` are rejected) +- **Blocked schemes**: `file://`, `javascript://`, `data://`, `vbscript://`, `about://`, `chrome://`, and browser-internal schemes +- **Allowed schemes**: `http://` and `https://` only (configurable via `CLI_ANYTHING_BROWSER_ALLOWED_SCHEMES`) +- **Private network blocking**: Optional via `CLI_ANYTHING_BROWSER_BLOCK_PRIVATE=true` (disabled by default) + +### DOM Content Risks +The Accessibility Tree includes all visible and hidden elements on a page. Malicious websites could: +- Craft ARIA labels with manipulative text (e.g., "Ignore previous instructions") +- Use aria-hidden elements to inject content not visible to users +- Create confusing DOM structures that mislead navigation + +**Mitigation**: When interacting with untrusted websites, consider: +1. Using the `--json` flag for structured output that's easier to parse safely +2. Sanitizing or filtering DOM content before including it in prompts +3. Limiting navigation to trusted domains + +### Private Network Access +By default, the browser can access localhost and private networks (192.168.x.x, 10.x.x.x, etc.). To block: +```bash +export CLI_ANYTHING_BROWSER_BLOCK_PRIVATE=true +cli-anything-browser page open http://localhost:8080 # Will be blocked +``` + +### Session Isolation +Multiple browser sessions share the same Chrome instance. Cookies and authentication state may persist across sessions. For sensitive operations, consider: +1. Using Chrome's guest mode or incognito +2. Clearing cookies between sessions +3. Using separate Chrome profiles for different security contexts diff --git a/skills/cli-anything-chromadb/SKILL.md b/skills/cli-anything-chromadb/SKILL.md new file mode 100644 index 000000000..f0b620cb4 --- /dev/null +++ b/skills/cli-anything-chromadb/SKILL.md @@ -0,0 +1,116 @@ +--- +name: "cli-anything-chromadb" +description: >- + Command-line interface for ChromaDB - A stateless CLI for managing vector database collections, documents, and semantic search. Designed for AI agents and automation via the ChromaDB HTTP API v2. +--- + +# cli-anything-chromadb + +A stateless command-line interface for ChromaDB vector database, built on the HTTP API v2. Designed for AI agents and power users who need to manage collections, documents, and run semantic queries without a browser UI. + +## Installation + +This CLI is installed as part of the cli-anything-chromadb package: + +```bash +pip install cli-anything-chromadb +``` + +**Prerequisites:** +- Python 3.10+ +- ChromaDB server running at localhost:8000 (or specify via --host) + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-chromadb --help + +# Start interactive REPL mode +cli-anything-chromadb + +# Check server health +cli-anything-chromadb --json server heartbeat + +# List all collections +cli-anything-chromadb --json collection list + +# Semantic search +cli-anything-chromadb --json query search --collection hub_knowledge --text "How to deploy" +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-chromadb +# Enter commands interactively with tab-completion and history +``` + +## Command Groups + +### server +Server health and version commands. + +| Command | Description | +|---------|-------------| +| `heartbeat` | Check ChromaDB server health | +| `version` | Get ChromaDB server version | + +### collection +Manage ChromaDB collections. + +| Command | Description | +|---------|-------------| +| `list` | List all collections | +| `create --name NAME` | Create a new collection | +| `delete --name NAME` | Delete a collection | +| `info NAME` | Get collection info | + +### document +Manage documents in collections. + +| Command | Description | +|---------|-------------| +| `add --collection C --id ID --document TEXT` | Add document(s) | +| `get --collection C` | Get documents | +| `delete --collection C --id ID` | Delete document(s) | +| `count --collection C` | Count documents | + +### query +Semantic search against collections. + +| Command | Description | +|---------|-------------| +| `search --collection C --text T` | Semantic search | + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-chromadb server heartbeat + +# JSON output for agents +cli-anything-chromadb --json server heartbeat +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use `--host`** to connect to non-default ChromaDB instances + +## Version + +1.0.0 diff --git a/skills/cli-anything-cloudanalyzer/SKILL.md b/skills/cli-anything-cloudanalyzer/SKILL.md new file mode 100644 index 000000000..97cb9ec75 --- /dev/null +++ b/skills/cli-anything-cloudanalyzer/SKILL.md @@ -0,0 +1,301 @@ +--- +name: "cli-anything-cloudanalyzer" +description: "Command-line interface for CloudAnalyzer — Agent-friendly harness for CloudAnalyzer, a QA platform for mapping, localization, and perception outputs. Supports 27 commands across 8 groups: point cloud evaluation, trajectory evaluation, ground segmentation QA, config-driven quality gates, baseline evolution, processing, visualization, and interactive REPL." +--- + +# cli-anything-cloudanalyzer + +Agent-friendly command-line harness for [CloudAnalyzer](https://github.com/rsasaki0109/CloudAnalyzer) — a QA platform for mapping, localization, and perception point cloud outputs. + +**27 commands** across 8 groups. + +## Installation + +```bash +pip install cli-anything-cloudanalyzer +``` + +**Prerequisites:** +- Python 3.10+ +- CloudAnalyzer: `pip install cloudanalyzer` + +## Global Options + +```bash +cli-anything-cloudanalyzer [--project FILE] [--json] COMMAND [ARGS]... +``` + +| Option | Description | +|---|---| +| `-p, --project TEXT` | Path to project JSON file | +| `--json` | Output results as JSON (for agent consumption) | + +## Command Groups + +### 1. evaluate — Point Cloud Evaluation (6 commands) + +#### evaluate run +Evaluate a point cloud against a reference (Chamfer, F1, AUC, Hausdorff). + +```bash +cli-anything-cloudanalyzer evaluate run source.pcd reference.pcd +cli-anything-cloudanalyzer --json evaluate run source.pcd reference.pcd +``` + +Options: `--plot TEXT`, `--threshold FLOAT` + +#### evaluate compare +Compare two point clouds with optional registration. + +```bash +cli-anything-cloudanalyzer evaluate compare src.pcd tgt.pcd --register gicp +``` + +Options: `--register TEXT` (icp/gicp/none) + +#### evaluate diff +Quick distance statistics between two point clouds. + +```bash +cli-anything-cloudanalyzer evaluate diff a.pcd b.pcd --threshold 0.1 +``` + +#### evaluate batch +Batch evaluation of multiple point clouds against a reference. + +```bash +cli-anything-cloudanalyzer --json evaluate batch results/ reference.pcd --min-auc 0.95 +``` + +Options: `--min-auc FLOAT`, `--max-chamfer FLOAT` + +#### evaluate ground +Evaluate ground segmentation quality (precision, recall, F1, IoU). + +```bash +cli-anything-cloudanalyzer --json evaluate ground est_ground.pcd est_ng.pcd ref_ground.pcd ref_ng.pcd --min-f1 0.9 +``` + +Options: `--voxel-size FLOAT`, `--min-precision FLOAT`, `--min-recall FLOAT`, `--min-f1 FLOAT`, `--min-iou FLOAT` + +#### evaluate pipeline +Filter, downsample, evaluate in one command. + +```bash +cli-anything-cloudanalyzer evaluate pipeline input.pcd reference.pcd -o output.pcd +``` + +--- + +### 2. trajectory — Trajectory Evaluation (3 commands) + +#### trajectory evaluate +Evaluate estimated vs reference trajectory (ATE, RPE, drift, lateral, longitudinal). + +```bash +cli-anything-cloudanalyzer --json trajectory evaluate est.csv gt.csv --max-ate 0.5 --max-lateral 0.3 +``` + +Options: `--max-ate FLOAT`, `--max-rpe FLOAT`, `--max-drift FLOAT`, `--min-coverage FLOAT`, `--max-lateral FLOAT`, `--max-longitudinal FLOAT`, `--align-origin`, `--align-rigid` + +#### trajectory batch +Batch trajectory evaluation. + +```bash +cli-anything-cloudanalyzer trajectory batch runs/ --reference-dir gt/ --max-drift 1.0 +``` + +#### trajectory run-evaluate +Integrated map + trajectory evaluation. + +```bash +cli-anything-cloudanalyzer trajectory run-evaluate map.pcd map_ref.pcd traj.csv traj_ref.csv +``` + +Options: `--min-auc FLOAT`, `--max-ate FLOAT` + +--- + +### 3. check — Config-Driven Quality Gate (2 commands) + +#### check run +Run unified QA from a config file. + +```bash +cli-anything-cloudanalyzer --json check run cloudanalyzer.yaml +``` + +Options: `--output-json TEXT` + +#### check init +Generate a starter config file. + +```bash +cli-anything-cloudanalyzer check init cloudanalyzer.yaml --profile integrated +``` + +Options: `--profile TEXT` (mapping/localization/perception/integrated), `--force` + +--- + +### 4. baseline — Baseline Evolution (3 commands) + +#### baseline decision +Decide whether to promote, keep, or reject a candidate baseline. + +```bash +cli-anything-cloudanalyzer --json baseline decision qa/summary.json --history-dir qa/history/ +``` + +Options: `--history TEXT` (repeatable), `--history-dir TEXT`, `--output-json TEXT` + +#### baseline save +Save a QA summary to the history directory. + +```bash +cli-anything-cloudanalyzer baseline save qa/summary.json --history-dir qa/history/ --keep 10 +``` + +Options: `--history-dir TEXT`, `--label TEXT`, `--keep INTEGER` + +#### baseline list +List saved baselines. + +```bash +cli-anything-cloudanalyzer --json baseline list --history-dir qa/history/ +``` + +--- + +### 5. process — Point Cloud Processing (6 commands) + +#### process downsample +Voxel grid downsampling. + +```bash +cli-anything-cloudanalyzer process downsample cloud.pcd -o down.pcd -v 0.05 +``` + +#### process sample +Random point sampling. + +```bash +cli-anything-cloudanalyzer process sample cloud.pcd -o sampled.pcd -n 10000 +``` + +#### process filter +Statistical outlier removal. + +```bash +cli-anything-cloudanalyzer process filter cloud.pcd -o filtered.pcd +``` + +#### process split +Split point cloud into grid tiles (writes metadata.yaml). + +```bash +cli-anything-cloudanalyzer process split large.pcd -o tiles/ -g 100 +``` + +#### process merge +Merge multiple point clouds. + +```bash +cli-anything-cloudanalyzer process merge a.pcd b.pcd -o merged.pcd +``` + +#### process convert +Convert between point cloud formats. + +```bash +cli-anything-cloudanalyzer process convert input.las -o output.pcd +``` + +--- + +### 6. inspect — Visualization (3 commands) + +#### inspect view +Open a point cloud viewer. + +```bash +cli-anything-cloudanalyzer inspect view cloud.pcd +``` + +#### inspect web +Interactive browser inspection. + +```bash +cli-anything-cloudanalyzer inspect web map.pcd ref.pcd --heatmap +``` + +#### inspect web-export +Export a static HTML inspection bundle. + +```bash +cli-anything-cloudanalyzer inspect web-export map.pcd ref.pcd -o bundle/ +``` + +--- + +### 7. info — Metadata (2 commands) + +#### info show +Show point cloud metadata. + +```bash +cli-anything-cloudanalyzer --json info show cloud.pcd +``` + +#### info version +Show CloudAnalyzer version. + +--- + +### 8. session — Session Management (2 commands) + +#### session new +Create a new harness project JSON file. + +```bash +cli-anything-cloudanalyzer session new -o project.json -n my-run +``` + +#### session history +Show recent operations for the project given with `-p` / `--project`. + +```bash +cli-anything-cloudanalyzer --project project.json session history --last 20 +``` + +--- + +## Typical Agent Workflows + +### Workflow 1: Evaluate and gate a point cloud + +```bash +cli-anything-cloudanalyzer --json evaluate run output.pcd reference.pcd +``` + +### Workflow 2: Config-driven QA pipeline + +```bash +cli-anything-cloudanalyzer check init cloudanalyzer.yaml --profile integrated +cli-anything-cloudanalyzer --json check run cloudanalyzer.yaml +``` + +### Workflow 3: Baseline management + +```bash +cli-anything-cloudanalyzer --json check run cloudanalyzer.yaml --output-json qa/summary.json +cli-anything-cloudanalyzer baseline save qa/summary.json --history-dir qa/history/ +cli-anything-cloudanalyzer --json baseline decision qa/summary.json --history-dir qa/history/ +``` + +### Workflow 4: Ground segmentation QA + +```bash +cli-anything-cloudanalyzer --json evaluate ground \ + est_ground.pcd est_ng.pcd ref_ground.pcd ref_ng.pcd --min-f1 0.9 +``` diff --git a/skills/cli-anything-cloudcompare/SKILL.md b/skills/cli-anything-cloudcompare/SKILL.md new file mode 100644 index 000000000..afa3a2ffd --- /dev/null +++ b/skills/cli-anything-cloudcompare/SKILL.md @@ -0,0 +1,789 @@ +--- +name: "cli-anything-cloudcompare" +description: "Command-line interface for CloudCompare — Agent-friendly harness for CloudCompare, the open-source 3D point cloud and mesh processing software. Supports 41 commands across 9 groups: project management, session control, point cloud operations (subsample, filter, segment, analyze), mesh operations, distance computation (C2C, C2M), transformations (ICP, matrix), export (LAS/LAZ/PLY/PCD/OBJ/STL/E57), and interactive REPL." +--- + +# cli-anything-cloudcompare + +Agent-friendly command-line harness for [CloudCompare](https://cloudcompare.org) — the open-source 3D point cloud and mesh processing software. + +**41 commands** across 9 groups. + +## Installation + +```bash +pip install cli-anything-cloudcompare +``` + +**Prerequisites:** +- Python 3.10+ +- CloudCompare installed on your system + - Linux (Flatpak): `flatpak install flathub org.cloudcompare.CloudCompare` + - macOS/Windows: download from https://cloudcompare.org + +**Tested with:** CloudCompare 2.13.2 (Flatpak, Linux) + +## Global Options + +These options must be placed **before** the subcommand: + +```bash +cli-anything-cloudcompare [--project FILE] [--json] COMMAND [ARGS]... +``` + +| Option | Description | +|---|---| +| `-p, --project TEXT` | Path to project JSON file | +| `--json` | Output results as JSON (for agent consumption) | + +## Command Groups + +### 1. project — Project Management (3 commands) + +#### project new +Create a new empty project file. + +```bash +# Create a project with default name +cli-anything-cloudcompare project new -o myproject.json + +# Create a project with a custom name +cli-anything-cloudcompare project new -o myproject.json -n "Bridge Survey 2024" + +# JSON output for agents +cli-anything-cloudcompare --json project new -o myproject.json +``` + +Options: `-o/--output TEXT` (required), `-n/--name TEXT` + +#### project info +Show project info and loaded entities. + +```bash +cli-anything-cloudcompare --project myproject.json project info + +# JSON output +cli-anything-cloudcompare --project myproject.json --json project info +``` + +#### project status +Show quick project status (cloud count, mesh count, last operation). + +```bash +cli-anything-cloudcompare --project myproject.json project status +``` + +--- + +### 2. session — Session Management (4 commands) + +#### session save +Save the current project state to disk. + +```bash +cli-anything-cloudcompare --project myproject.json session save +``` + +#### session history +Show recent operation history. + +```bash +# Show last 10 operations (default) +cli-anything-cloudcompare --project myproject.json session history + +# Show last 5 operations +cli-anything-cloudcompare --project myproject.json session history -n 5 +``` + +Options: `-n/--last INTEGER` + +#### session set-format +Update the default export format for future operations. + +```bash +# Set default cloud export to LAS +cli-anything-cloudcompare --project myproject.json session set-format --cloud-fmt LAS --cloud-ext las + +# Set default mesh export to OBJ +cli-anything-cloudcompare --project myproject.json session set-format --mesh-fmt OBJ --mesh-ext obj + +# Set both cloud and mesh defaults +cli-anything-cloudcompare --project myproject.json session set-format \ + --cloud-fmt PLY --cloud-ext ply \ + --mesh-fmt STL --mesh-ext stl +``` + +Options: `--cloud-fmt TEXT`, `--cloud-ext TEXT`, `--mesh-fmt TEXT`, `--mesh-ext TEXT` + +#### session undo +Remove the last operation from history (soft undo — does not delete output files). + +```bash +cli-anything-cloudcompare --project myproject.json session undo +``` + +--- + +### 3. cloud — Point Cloud Operations (21 commands) + +All cloud commands take `CLOUD_INDEX` (0-based integer from `cloud list`) and most accept `--add-to-project` to register the output back into the project. + +#### cloud add +Add a point cloud file to the project. + +```bash +# Add a LAS file +cli-anything-cloudcompare --project myproject.json cloud add /data/scan.las + +# Add with a label +cli-anything-cloudcompare --project myproject.json cloud add /data/scan.las -l "roof scan" +``` + +Options: `-l/--label TEXT` + +#### cloud list +List all clouds currently in the project. + +```bash +cli-anything-cloudcompare --project myproject.json cloud list + +# JSON output for parsing indices +cli-anything-cloudcompare --project myproject.json --json cloud list +``` + +#### cloud convert +Convert a cloud from one format to another (format determined by file extension). + +```bash +# LAS → PLY +cli-anything-cloudcompare cloud convert /data/scan.las /data/scan.ply + +# PCD → LAS +cli-anything-cloudcompare cloud convert /data/cloud.pcd /data/cloud.las +``` + +#### cloud subsample +Reduce the number of points using RANDOM, SPATIAL, or OCTREE method. + +```bash +# Random: keep 100 000 points +cli-anything-cloudcompare --project myproject.json cloud subsample 0 \ + -o /data/sub_random.las -m random -n 100000 + +# Spatial: minimum distance 0.05 m between points +cli-anything-cloudcompare --project myproject.json cloud subsample 0 \ + -o /data/sub_spatial.las -m spatial -n 0.05 + +# Octree: level 8 +cli-anything-cloudcompare --project myproject.json cloud subsample 0 \ + -o /data/sub_octree.las -m octree -n 8 --add-to-project +``` + +Options: `-o/--output TEXT` (required), `-m/--method [random|spatial|octree]`, `-n/--param FLOAT`, `--add-to-project` + +#### cloud crop +Crop a cloud to an axis-aligned bounding box. + +```bash +# Keep points inside the box +cli-anything-cloudcompare --project myproject.json cloud crop 0 \ + -o /data/cropped.las \ + --xmin 0.0 --ymin 0.0 --zmin 0.0 \ + --xmax 10.0 --ymax 10.0 --zmax 5.0 + +# Keep points OUTSIDE the box +cli-anything-cloudcompare --project myproject.json cloud crop 0 \ + -o /data/exterior.las \ + --xmin 0.0 --ymin 0.0 --zmin 0.0 \ + --xmax 10.0 --ymax 10.0 --zmax 5.0 --outside +``` + +Options: `-o/--output TEXT` (required), `--xmin/ymin/zmin/xmax/ymax/zmax FLOAT` (all required), `--outside`, `--add-to-project` + +#### cloud normals +Compute surface normals via the octree method. + +```bash +# Compute normals at octree level 6 +cli-anything-cloudcompare --project myproject.json cloud normals 0 \ + -o /data/with_normals.ply --level 6 + +# Compute normals oriented toward +Z +cli-anything-cloudcompare --project myproject.json cloud normals 0 \ + -o /data/with_normals.ply --level 6 --orientation plus_z --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--level INTEGER` (1–10), `--orientation [plus_x|plus_y|plus_z|minus_x|minus_y|minus_z]`, `--add-to-project` + +#### cloud invert-normals +Flip all normal vectors in the cloud. + +```bash +cli-anything-cloudcompare --project myproject.json cloud invert-normals 0 \ + -o /data/flipped_normals.ply --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--add-to-project` + +#### cloud filter-sor +Statistical Outlier Removal — removes isolated noise points. + +```bash +# Default parameters (k=6 neighbours, 1.0 std ratio) +cli-anything-cloudcompare --project myproject.json cloud filter-sor 0 \ + -o /data/denoised.las + +# Custom parameters +cli-anything-cloudcompare --project myproject.json cloud filter-sor 0 \ + -o /data/denoised.las --nb-points 12 --std-ratio 2.0 --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--nb-points INTEGER`, `--std-ratio FLOAT`, `--add-to-project` + +#### cloud noise-filter +Remove noisy points using the PCL noise filter (KNN or radius mode). + +```bash +# KNN mode (default) +cli-anything-cloudcompare --project myproject.json cloud noise-filter 0 \ + -o /data/clean.las --knn 8 --noisiness 1.0 + +# Radius mode +cli-anything-cloudcompare --project myproject.json cloud noise-filter 0 \ + -o /data/clean.las --radius 0.1 --use-radius --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--knn INTEGER`, `--noisiness FLOAT`, `--radius FLOAT`, `--use-radius`, `--absolute`, `--add-to-project` + +#### cloud filter-csf +Ground filtering using the Cloth Simulation Filter (CSF) algorithm. Separates ground from off-ground points (buildings, vegetation). + +```bash +# Extract ground only — mixed terrain +cli-anything-cloudcompare --project myproject.json cloud filter-csf 0 \ + --ground /data/ground.las --scene relief + +# Split ground + off-ground — urban scene +cli-anything-cloudcompare --project myproject.json cloud filter-csf 0 \ + --ground /data/ground.las \ + --offground /data/buildings.las \ + --scene flat --cloth-resolution 0.5 --class-threshold 0.3 + +# Steep forested slope with slope post-processing +cli-anything-cloudcompare --project myproject.json cloud filter-csf 0 \ + --ground /data/terrain.las --scene slope --proc-slope --add-to-project +``` + +Options: `-g/--ground TEXT` (required), `-u/--offground TEXT`, `--scene [slope|relief|flat]`, `--cloth-resolution FLOAT`, `--class-threshold FLOAT`, `--max-iteration INTEGER`, `--proc-slope`, `--add-to-project` + +#### cloud filter-sf +Filter a cloud by scalar field value range (keep points where SF ∈ [min, max]). + +```bash +# Keep points with SF value between 10 and 50 +cli-anything-cloudcompare --project myproject.json cloud filter-sf 0 \ + -o /data/filtered.las --min 10.0 --max 50.0 + +# Filter using a specific SF index +cli-anything-cloudcompare --project myproject.json cloud filter-sf 0 \ + -o /data/filtered.las --min 0.0 --max 1.5 --sf-index 2 --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--min FLOAT` (required), `--max FLOAT` (required), `--sf-index INTEGER`, `--add-to-project` + +#### cloud sf-from-coord +Convert a coordinate axis (X/Y/Z) to a scalar field. Commonly used to create a height (Z) scalar field. + +```bash +# Create Z scalar field (height) +cli-anything-cloudcompare --project myproject.json cloud sf-from-coord 0 \ + -o /data/with_z_sf.las --dim z --add-to-project + +# Create X scalar field with a specific active index +cli-anything-cloudcompare --project myproject.json cloud sf-from-coord 0 \ + -o /data/with_x_sf.las --dim x --sf-index 0 +``` + +Options: `-o/--output TEXT` (required), `--dim [x|y|z]` (default: z), `--sf-index INTEGER`, `--add-to-project` + +#### cloud sf-filter-z +Convenience command: convert Z → scalar field and filter by height range in one step. + +```bash +# Extract points between z=1.0 m and z=2.5 m +cli-anything-cloudcompare --project myproject.json cloud sf-filter-z 0 \ + -o /data/slice.las --min 1.0 --max 2.5 --add-to-project + +# Only apply upper bound +cli-anything-cloudcompare --project myproject.json cloud sf-filter-z 0 \ + -o /data/below_5m.las --max 5.0 +``` + +Options: `-o/--output TEXT` (required), `--min FLOAT`, `--max FLOAT`, `--add-to-project` + +#### cloud sf-to-rgb +Convert the active scalar field to RGB colours. + +```bash +cli-anything-cloudcompare --project myproject.json cloud sf-to-rgb 0 \ + -o /data/coloured.ply --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--add-to-project` + +#### cloud rgb-to-sf +Convert RGB colours to a scalar field (luminance value). + +```bash +cli-anything-cloudcompare --project myproject.json cloud rgb-to-sf 0 \ + -o /data/luminance.las --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--add-to-project` + +#### cloud curvature +Compute curvature scalar field (MEAN or GAUSS). + +```bash +# Mean curvature with radius 0.5 m +cli-anything-cloudcompare --project myproject.json cloud curvature 0 \ + -o /data/curvature.las --type mean --radius 0.5 + +# Gaussian curvature +cli-anything-cloudcompare --project myproject.json cloud curvature 0 \ + -o /data/curvature.las --type gauss --radius 0.5 --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--type [mean|gauss]`, `-r/--radius FLOAT`, `--add-to-project` + +#### cloud roughness +Compute roughness scalar field (deviation from local best-fit plane). + +```bash +cli-anything-cloudcompare --project myproject.json cloud roughness 0 \ + -o /data/roughness.las --radius 0.2 --add-to-project +``` + +Options: `-o/--output TEXT` (required), `-r/--radius FLOAT`, `--add-to-project` + +#### cloud density +Compute point density scalar field. + +```bash +# KNN density +cli-anything-cloudcompare --project myproject.json cloud density 0 \ + -o /data/density.las --type knn --radius 0.5 + +# Surface density +cli-anything-cloudcompare --project myproject.json cloud density 0 \ + -o /data/density.las --type surface --radius 1.0 --add-to-project +``` + +Options: `-o/--output TEXT` (required), `-r/--radius FLOAT`, `--type [knn|surface|volume]`, `--add-to-project` + +#### cloud segment-cc +Segment cloud into connected components (clusters). Each component is saved as a separate file. + +```bash +# Segment with octree level 8, minimum 100 points per component +cli-anything-cloudcompare --project myproject.json cloud segment-cc 0 \ + -o /data/components/ --octree-level 8 --min-points 100 + +# Save components as PLY files +cli-anything-cloudcompare --project myproject.json cloud segment-cc 0 \ + -o /data/components/ --octree-level 6 --min-points 50 --fmt ply +``` + +Options: `-o/--output-dir TEXT` (required), `--octree-level INTEGER`, `--min-points INTEGER`, `--fmt TEXT` + +#### cloud merge +Merge all clouds in the project into a single cloud. + +```bash +cli-anything-cloudcompare --project myproject.json cloud merge \ + -o /data/merged.las --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--add-to-project` + +#### cloud mesh-delaunay +Build a 2.5-D Delaunay triangulation mesh from a cloud. + +```bash +# Basic Delaunay mesh +cli-anything-cloudcompare --project myproject.json cloud mesh-delaunay 0 \ + -o /data/surface.obj + +# Best-fit plane with max edge length limit +cli-anything-cloudcompare --project myproject.json cloud mesh-delaunay 0 \ + -o /data/surface.ply --best-fit --max-edge-length 2.0 --add-to-project +``` + +Options: `-o/--output TEXT` (required), `--best-fit`, `--max-edge-length FLOAT`, `--add-to-project` + +--- + +### 4. mesh — Mesh Operations (3 commands) + +#### mesh add +Add a mesh file to the project. + +```bash +cli-anything-cloudcompare --project myproject.json mesh add /data/model.obj + +# Add with label +cli-anything-cloudcompare --project myproject.json mesh add /data/model.ply -l "building model" +``` + +Options: `-l/--label TEXT` + +#### mesh list +List all meshes in the project. + +```bash +cli-anything-cloudcompare --project myproject.json mesh list + +# JSON output +cli-anything-cloudcompare --project myproject.json --json mesh list +``` + +#### mesh sample +Sample a point cloud from a mesh surface. + +```bash +# Sample 50 000 points from mesh at index 0 +cli-anything-cloudcompare --project myproject.json mesh sample 0 \ + -o /data/sampled.las -n 50000 + +# Add sampled cloud back to project +cli-anything-cloudcompare --project myproject.json mesh sample 0 \ + -o /data/sampled.las -n 100000 --add-to-project +``` + +Options: `-o/--output TEXT` (required), `-n/--count INTEGER`, `--add-to-project` + +--- + +### 5. distance — Distance Computation (2 commands) + +#### distance c2c +Compute cloud-to-cloud distances. Adds a distance scalar field to the compared cloud. + +```bash +# Compare cloud 1 to reference cloud 0 +cli-anything-cloudcompare --project myproject.json distance c2c \ + --compare 1 --reference 0 -o /data/distances.las + +# Split into X/Y/Z components at octree level 8 +cli-anything-cloudcompare --project myproject.json distance c2c \ + --compare 1 --reference 0 -o /data/distances.las \ + --split-xyz --octree-level 8 --add-to-project +``` + +Options: `--compare TEXT` (required), `--reference TEXT` (required), `-o/--output TEXT` (required), `--split-xyz`, `--octree-level INTEGER`, `--add-to-project` + +#### distance c2m +Compute cloud-to-mesh distances. Adds a distance scalar field to the cloud. + +```bash +# Basic cloud-to-mesh distance +cli-anything-cloudcompare --project myproject.json distance c2m \ + --cloud 0 --mesh 0 -o /data/c2m_dist.las + +# With flipped normals and unsigned distances +cli-anything-cloudcompare --project myproject.json distance c2m \ + --cloud 0 --mesh 0 -o /data/c2m_dist.las \ + --flip-normals --unsigned --add-to-project +``` + +Options: `--cloud INTEGER` (required), `--mesh INTEGER` (required), `-o/--output TEXT` (required), `--flip-normals`, `--unsigned`, `--add-to-project` + +--- + +### 6. transform — Transformations and Registration (2 commands) + +#### transform apply +Apply a 4×4 rigid-body transformation matrix to a cloud. + +```bash +# Apply a transformation matrix from file +cli-anything-cloudcompare --project myproject.json transform apply 0 \ + -o /data/transformed.las -m /data/matrix.txt + +# Apply the inverse transformation +cli-anything-cloudcompare --project myproject.json transform apply 0 \ + -o /data/transformed.las -m /data/matrix.txt --inverse --add-to-project +``` + +The matrix file must contain 4 rows of 4 space-separated values: +``` +1 0 0 0 +0 1 0 0 +0 0 1 0 +0 0 0 1 +``` + +Options: `-o/--output TEXT` (required), `-m/--matrix TEXT` (required), `--inverse`, `--add-to-project` + +#### transform icp +Run ICP (Iterative Closest Point) registration to align one cloud to another. + +```bash +# Basic ICP alignment +cli-anything-cloudcompare --project myproject.json transform icp \ + --aligned 1 --reference 0 -o /data/aligned.las + +# ICP with overlap and iteration control +cli-anything-cloudcompare --project myproject.json transform icp \ + --aligned 1 --reference 0 -o /data/aligned.las \ + --max-iter 50 --overlap 80 --min-error-diff 1e-6 --add-to-project +``` + +Options: `--aligned INTEGER` (required), `--reference INTEGER` (required), `-o/--output TEXT` (required), `--max-iter INTEGER`, `--min-error-diff FLOAT`, `--overlap FLOAT`, `--add-to-project` + +--- + +### 7. export — Export Clouds and Meshes (4 commands) + +#### export formats +List all available export format presets. + +```bash +cli-anything-cloudcompare export formats + +# JSON output +cli-anything-cloudcompare --json export formats +``` + +#### export cloud +Export a cloud to a target format. + +```bash +# Export cloud at index 0 as LAS +cli-anything-cloudcompare --project myproject.json export cloud 0 /data/output.las + +# Export as PLY using preset +cli-anything-cloudcompare --project myproject.json export cloud 0 /data/output.ply -f ply + +# Overwrite if file exists +cli-anything-cloudcompare --project myproject.json export cloud 0 /data/output.las -f las --overwrite +``` + +Supported presets: `las`, `laz`, `ply`, `pcd`, `xyz`, `asc`, `csv`, `bin`, `e57` + +Options: `-f/--preset TEXT`, `--overwrite` + +#### export mesh +Export a mesh to a target format. + +```bash +# Export mesh at index 0 as OBJ +cli-anything-cloudcompare --project myproject.json export mesh 0 /data/model.obj + +# Export as STL +cli-anything-cloudcompare --project myproject.json export mesh 0 /data/model.stl -f stl --overwrite +``` + +Supported presets: `obj`, `stl`, `ply`, `bin` + +Options: `-f/--preset TEXT`, `--overwrite` + +#### export batch +Batch export all project clouds to a directory. + +```bash +# Export all clouds as LAS +cli-anything-cloudcompare --project myproject.json export batch \ + -d /data/exports/ -f las + +# Overwrite existing files +cli-anything-cloudcompare --project myproject.json export batch \ + -d /data/exports/ -f ply --overwrite +``` + +Options: `-d/--output-dir TEXT` (required), `-f/--preset TEXT`, `--overwrite` + +--- + +### 8. info — Installation Info (1 command) + +Show CloudCompare installation path and version. + +```bash +cli-anything-cloudcompare info + +# JSON output +cli-anything-cloudcompare --json info +``` + +--- + +### 9. repl — Interactive REPL (1 command) + +Start the interactive REPL session with history and undo support. + +```bash +# Start REPL without a project +cli-anything-cloudcompare repl + +# Start REPL with an existing project +cli-anything-cloudcompare repl -p myproject.json + +# Equivalent: run without subcommand +cli-anything-cloudcompare --project myproject.json +``` + +Options: `-p/--project TEXT` + +Inside the REPL, type `help` to list available commands or `session undo` to revert the last operation. + +--- + +## Supported File Formats + +| Format | Extension | Read | Write | Notes | +|---|---|---|---|---| +| LAS | `.las` | ✓ | ✓ | LiDAR standard, supports intensity/RGB | +| LAZ | `.laz` | ✓ | ✓ | Compressed LAS | +| PLY | `.ply` | ✓ | ✓ | ASCII or binary | +| PCD | `.pcd` | ✓ | ✓ | PCL format | +| XYZ | `.xyz` | ✓ | ✓ | Plain text XYZ | +| ASC | `.asc` | ✓ | ✓ | ASCII with header | +| CSV | `.csv` | ✓ | ✓ | Comma-separated | +| E57 | `.e57` | ✓ | ✓ | ASTM scanner exchange | +| BIN | `.bin` | ✓ | ✓ | CloudCompare native binary | +| OBJ | `.obj` | ✓ | ✓ | Mesh (Wavefront) | +| STL | `.stl` | ✓ | ✓ | Mesh (3D printing) | + +--- + +## Typical Workflows + +### Workflow 1: LiDAR Pre-processing Pipeline + +```bash +P=myproject.json + +# 1. Create project and load scan +cli-anything-cloudcompare project new -o $P +cli-anything-cloudcompare --project $P cloud add /data/scan.las +cli-anything-cloudcompare --project $P cloud list # note index → 0 + +# 2. Denoise +cli-anything-cloudcompare --project $P cloud filter-sor 0 \ + -o /data/denoised.las --nb-points 6 --std-ratio 1.0 --add-to-project + +# 3. Subsample to 5 cm grid +cli-anything-cloudcompare --project $P cloud subsample 1 \ + -o /data/subsampled.las -m spatial -n 0.05 --add-to-project + +# 4. Extract ground plane (CSF) +cli-anything-cloudcompare --project $P cloud filter-csf 2 \ + --ground /data/ground.las --offground /data/objects.las \ + --scene relief --add-to-project + +# 5. Export result +cli-anything-cloudcompare --project $P export cloud 3 /data/ground_final.las -f las --overwrite +``` + +### Workflow 2: Change Detection Between Two Scans + +```bash +P=compare.json +cli-anything-cloudcompare project new -o $P +cli-anything-cloudcompare --project $P cloud add /data/scan_2023.las # index 0 +cli-anything-cloudcompare --project $P cloud add /data/scan_2024.las # index 1 + +# ICP alignment (align 2024 to 2023) +cli-anything-cloudcompare --project $P transform icp \ + --aligned 1 --reference 0 -o /data/aligned_2024.las \ + --overlap 90 --add-to-project # index 2 + +# Cloud-to-cloud distance +cli-anything-cloudcompare --project $P distance c2c \ + --compare 2 --reference 0 -o /data/change_map.las --add-to-project + +# Export as LAS with distance scalar field +cli-anything-cloudcompare --project $P export cloud 3 /data/change_map_final.las --overwrite +``` + +### Workflow 3: Height Slice Extraction + +```bash +P=slice.json +cli-anything-cloudcompare project new -o $P +cli-anything-cloudcompare --project $P cloud add /data/building.las + +# Extract points at 2–3 m height (floor level) +cli-anything-cloudcompare --project $P cloud sf-filter-z 0 \ + -o /data/floor_slice.las --min 2.0 --max 3.0 --add-to-project + +# Export +cli-anything-cloudcompare --project $P export cloud 1 /data/floor_slice_out.las --overwrite +``` + +### Workflow 4: Surface Reconstruction + +```bash +P=mesh.json +cli-anything-cloudcompare project new -o $P +cli-anything-cloudcompare --project $P cloud add /data/terrain.las + +# Compute normals +cli-anything-cloudcompare --project $P cloud normals 0 \ + -o /data/with_normals.ply --level 6 --orientation plus_z --add-to-project + +# Delaunay mesh +cli-anything-cloudcompare --project $P cloud mesh-delaunay 1 \ + -o /data/terrain_mesh.obj --max-edge-length 1.0 --add-to-project + +# Export mesh +cli-anything-cloudcompare --project $P export mesh 0 /data/terrain_mesh_final.obj --overwrite +``` + +--- + +## Error Handling + +| Exit Code | Meaning | +|---|---| +| `0` | Success | +| `1` | General error (see stderr for details) | +| `2` | Invalid arguments | + +Common errors: + +```bash +# CloudCompare not found +# → Install CloudCompare; check `cli-anything-cloudcompare info` + +# Index out of range +# → Run `cloud list` or `mesh list` to confirm valid indices + +# File already exists (no --overwrite) +# → Add --overwrite flag to export commands + +# fcntl not available (Windows) +# → File locking is skipped automatically; project save still works +``` + +--- + +## For AI Agents + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** — 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file arguments +5. **Verify output files exist** after export operations +6. **Chain with `--add-to-project`** to build multi-step pipelines without re-loading files +7. **Use `cloud list --json`** to discover valid cloud indices before each operation +8. **Use `export formats --json`** to discover available format presets + +## Version + +| Component | Version | +|---|---| +| cli-anything-cloudcompare | 1.0.0 | +| CloudCompare (tested) | 2.13.2 | +| Python (minimum) | 3.10 | diff --git a/skills/cli-anything-comfyui/SKILL.md b/skills/cli-anything-comfyui/SKILL.md new file mode 100644 index 000000000..ea31942b7 --- /dev/null +++ b/skills/cli-anything-comfyui/SKILL.md @@ -0,0 +1,190 @@ +--- +name: "cli-anything-comfyui" +description: >- + Command-line interface for ComfyUI - AI image generation workflow management via ComfyUI REST API. Designed for AI agents and power users who need to queue workflows, manage models, download generated images, and monitor the generation queue without a GUI. +--- + +# cli-anything-comfyui + +AI image generation workflow management via the ComfyUI REST API. Designed for AI agents and power users who need to queue workflows, manage models, download generated images, and monitor the generation queue without a GUI. + +## Installation + +This CLI is installed as part of the cli-anything-comfyui package: + +```bash +pip install cli-anything-comfyui +``` + +**Prerequisites:** +- Python 3.10+ +- ComfyUI must be installed and running at http://localhost:8188 + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-comfyui --help + +# Start interactive REPL mode +cli-anything-comfyui repl + +# Check server stats +cli-anything-comfyui system stats + +# Run with JSON output (for agent consumption) +cli-anything-comfyui --json system stats +``` + +### REPL Mode + +Start an interactive session for exploratory use: + +```bash +cli-anything-comfyui repl +# Enter commands interactively with tab-completion and history +``` + +## Command Groups + +### Workflow + +Workflow management commands. + +| Command | Description | +|---------|-------------| +| `list` | List saved workflows | +| `load` | Load a workflow from a JSON file | +| `validate` | Validate a workflow JSON against the ComfyUI node graph | + +### Queue + +Generation queue management. + +| Command | Description | +|---------|-------------| +| `prompt` | Queue a workflow for execution | +| `status` | Show current queue status (running and pending) | +| `clear` | Clear the generation queue | +| `history` | Show prompt execution history | +| `interrupt` | Interrupt the currently running generation | + +### Models + +Model discovery commands. + +| Command | Description | +|---------|-------------| +| `checkpoints` | List available checkpoint models | +| `loras` | List available LoRA models | +| `vaes` | List available VAE models | +| `controlnets` | List available ControlNet models | +| `node-info` | Show detailed info for a specific node type | +| `list-nodes` | List all available node types | + +### Images + +Generated image management. + +| Command | Description | +|---------|-------------| +| `list` | List generated images on the server | +| `download` | Download a specific generated image | +| `download-all` | Download all images from a prompt execution | + +### System + +Server status and information. + +| Command | Description | +|---------|-------------| +| `stats` | Show ComfyUI system statistics (GPU, CPU, memory) | +| `info` | Show ComfyUI server info and extensions | + +## Examples + +### Check System Status + +```bash +# Server stats +cli-anything-comfyui system stats + +# Server info +cli-anything-comfyui system info +``` + +### Discover Available Models + +```bash +# List checkpoints +cli-anything-comfyui models checkpoints + +# List LoRAs +cli-anything-comfyui models loras + +# List all node types +cli-anything-comfyui models list-nodes +``` + +### Queue and Monitor Generation + +```bash +# Queue a workflow +cli-anything-comfyui queue prompt --workflow my_workflow.json + +# Check queue status +cli-anything-comfyui queue status + +# View execution history +cli-anything-comfyui --json queue history +``` + +### Download Generated Images + +```bash +# List generated images +cli-anything-comfyui images list + +# Download a specific image +cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./out.png + +# Download all images from a prompt +cli-anything-comfyui images download-all --prompt-id --output-dir ./outputs +``` + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-comfyui system stats + +# JSON output for agents +cli-anything-comfyui --json system stats +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify ComfyUI is running** with `system stats` before other commands + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 diff --git a/skills/cli-anything-dify-workflow/SKILL.md b/skills/cli-anything-dify-workflow/SKILL.md new file mode 100644 index 000000000..68eae1c3b --- /dev/null +++ b/skills/cli-anything-dify-workflow/SKILL.md @@ -0,0 +1,56 @@ +--- +name: "cli-anything-dify-workflow" +description: Wrapper for the Dify workflow DSL CLI. Create, inspect, validate, edit, and export Dify workflow files through a CLI-Anything harness. +--- + +# Dify Workflow CLI Skill + +## Installation + +Install the upstream Dify workflow CLI first: + +```bash +python -m pip install "dify-ai-workflow-tools @ git+https://github.com/Akabane71/dify-workflow-cli.git@main" +``` + +Then install the CLI-Anything harness: + +```bash +pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=dify-workflow/agent-harness +``` + +## Usage + +The harness forwards to the upstream `dify-workflow` CLI. + +```bash +cli-anything-dify-workflow guide +cli-anything-dify-workflow list-node-types +cli-anything-dify-workflow create -o workflow.yaml --mode workflow --template llm +cli-anything-dify-workflow inspect workflow.yaml -j +cli-anything-dify-workflow validate workflow.yaml -j +cli-anything-dify-workflow edit add-node -f workflow.yaml --type code --title "Process" +cli-anything-dify-workflow config set-model -f app.yaml --provider openai --name gpt-4o +``` + +## Command Groups + +- `guide` +- `list-node-types` +- `create` +- `inspect` +- `validate` +- `checklist` +- `edit add-node|remove-node|update-node|add-edge|remove-edge|set-title` +- `config set-model|set-prompt|add-variable|set-opening|add-question|add-tool|remove-tool` +- `export` +- `import` +- `diff` +- `layout` + +## Agent Guidance + +- Prefer `-j` / `--json-output` on upstream commands when available. +- The harness itself is a wrapper. Real workflow logic is provided by the upstream project. +- If `dify-workflow` is not on PATH but the `dify_workflow` Python package is installed, the wrapper falls back to `python -m dify_workflow.cli`. +- All operations are local file edits on Dify YAML/JSON DSL files. diff --git a/skills/cli-anything-drawio/SKILL.md b/skills/cli-anything-drawio/SKILL.md new file mode 100644 index 000000000..3ed1eb57e --- /dev/null +++ b/skills/cli-anything-drawio/SKILL.md @@ -0,0 +1,213 @@ +--- +name: "cli-anything-drawio" +description: >- + Command-line interface for Drawio - A CLI harness for **Draw.io** — create, edit, and export diagrams from the command line.... +--- + +# cli-anything-drawio + +A CLI harness for **Draw.io** — create, edit, and export diagrams from the command line. + +## Installation + +This CLI is installed as part of the cli-anything-drawio package: + +```bash +pip install cli-anything-drawio +``` + +**Prerequisites:** +- Python 3.10+ +- drawio must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-drawio --help + +# Start interactive REPL mode +cli-anything-drawio + +# Create a new project +cli-anything-drawio project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-drawio --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-drawio +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management: new, open, save, info. + +| Command | Description | +|---------|-------------| +| `new` | Create a new blank diagram | +| `open` | Open an existing .drawio project file | +| `save` | Save the current project | +| `info` | Show detailed project information | +| `xml` | Print the raw XML of the current project | +| `presets` | List available page size presets | + + +### Shape + +Shape operations: add, remove, move, resize, style. + +| Command | Description | +|---------|-------------| +| `add` | Add a shape to the diagram | +| `remove` | Remove a shape by ID | +| `list` | List all shapes on a page | +| `label` | Update a shape's label text | +| `move` | Move a shape to new coordinates | +| `resize` | Resize a shape | +| `style` | Set a style property on a shape | +| `info` | Show detailed info about a shape | +| `types` | List all available shape types | + + +### Connect + +Connector operations: add, remove, style. + +| Command | Description | +|---------|-------------| +| `add` | Add a connector between two shapes | +| `remove` | Remove a connector by ID | +| `label` | Update a connector's label | +| `style` | Set a style property on a connector | +| `list` | List all connectors on a page | +| `styles` | List available edge styles | + + +### Page + +Page operations: add, remove, rename, list. + +| Command | Description | +|---------|-------------| +| `add` | Add a new page | +| `remove` | Remove a page by index | +| `rename` | Rename a page | +| `list` | List all pages | + + +### Export + +Export operations: render to PNG, PDF, SVG. + +| Command | Description | +|---------|-------------| +| `render` | Export the diagram to a file | +| `formats` | List available export formats | + + +### Session + +Session management: status, undo, redo. + +| Command | Description | +|---------|-------------| +| `status` | Show current session status | +| `undo` | Undo the last operation | +| `redo` | Redo the last undone operation | +| `save-state` | Save session state to disk | +| `list` | List all saved sessions | + + + + +## Examples + + +### Create a New Project + +Create a new drawio project file. + +```bash +cli-anything-drawio project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-drawio --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-drawio +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-drawio --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-drawio project info -p project.json + +# JSON output for agents +cli-anything-drawio --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/skills/cli-anything-eth2-quickstart/SKILL.md b/skills/cli-anything-eth2-quickstart/SKILL.md new file mode 100644 index 000000000..d498b0518 --- /dev/null +++ b/skills/cli-anything-eth2-quickstart/SKILL.md @@ -0,0 +1,73 @@ +--- +name: "cli-anything-eth2-quickstart" +description: >- + Use eth2-quickstart to autonomously deploy a hardened Ethereum node, install + execution and consensus clients, configure validator metadata, expose RPC + safely, and inspect node health with structured JSON output. +--- + +# cli-anything-eth2-quickstart + +Agent-native harness for the `chimera-defi/eth2-quickstart` automation repo. +This CLI wraps the repo's canonical shell scripts instead of replacing them. + +## When To Use + +Use this skill when the task involves: + +- bootstrapping a fresh Ethereum node host +- installing execution and consensus clients with explicit client diversity +- enabling MEV-Boost or Commit-Boost workflows +- exposing RPC through Nginx or Caddy +- updating validator fee recipient or graffiti settings without handling secrets +- checking machine-readable health with `--json` + +## Core Commands + +```bash +# Canonical machine-readable health +cli-anything-eth2-quickstart --json health-check + +# Phase 2 install with explicit client choices +cli-anything-eth2-quickstart --json install-clients \ + --network mainnet \ + --execution-client geth \ + --consensus-client lighthouse \ + --mev mev-boost \ + --confirm + +# Guided node setup +cli-anything-eth2-quickstart --json setup-node \ + --phase auto \ + --execution-client geth \ + --consensus-client prysm \ + --mev commit-boost \ + --confirm + +# Validator metadata only; no key import +cli-anything-eth2-quickstart --json configure-validator \ + --consensus-client prysm \ + --fee-recipient 0x1111111111111111111111111111111111111111 \ + --graffiti "CLI-Anything" + +# Install nginx-backed RPC exposure +cli-anything-eth2-quickstart --json start-rpc \ + --web-stack nginx \ + --server-name rpc.example.org \ + --confirm +``` + +## Safety Rules + +- Always use `--json` for agent parsing. +- Require human confirmation before `setup-node`, `install-clients`, or `start-rpc`. +- Do not generate validator keys. +- Do not remove secrets or wallet material. +- Treat `configure-validator` as metadata and operator-guidance only. +- Respect the reboot boundary between Phase 1 and Phase 2. + +## Runtime Expectations + +- Operates on a local `eth2-quickstart` checkout. +- Discovers repo root from `--repo-root`, `ETH2QS_REPO_ROOT`, or current working directory. +- Writes compatible overrides into `config/user_config.env` when flags map directly to repo settings. diff --git a/skills/cli-anything-exa/SKILL.md b/skills/cli-anything-exa/SKILL.md new file mode 100644 index 000000000..70a4e81a4 --- /dev/null +++ b/skills/cli-anything-exa/SKILL.md @@ -0,0 +1,107 @@ +--- +name: "cli-anything-exa" +description: >- + Agent-native CLI for Exa web search and content retrieval workflows. +--- + +# Exa CLI Skill + +## Identity +- **Name**: cli-anything-exa +- **Version**: 1.0.0 +- **Category**: search +- **Entry Point**: `cli-anything-exa` + +## What This CLI Does +Provides an agent-native command-line interface to the Exa API — a neural search engine +optimised for AI agent workflows. Supports web search across multiple modes (fast, deep, +deep-reasoning) and fetching full-text or highlighted page contents. + +## Prerequisites +- Python >= 3.10 +- `pip install cli-anything-exa` +- `export EXA_API_KEY="your-api-key"` (get one at https://dashboard.exa.ai/api-keys) + +## Installation +```bash +pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=exa/agent-harness +``` + +## Command Reference + +### search — Web search +```bash +cli-anything-exa search "" [OPTIONS] + +Options: + --type auto|fast|instant|deep|deep-reasoning (default: auto) + --num-results / -n 1–100 (default: 10) + --category company|people|research-paper|news|personal-site|financial-report + --content highlights|text|summary|none (default: highlights) + --freshness smart|always|never (default: smart) + --include-domains DOMAIN (repeatable) + --exclude-domains DOMAIN (repeatable) + --from DATE ISO 8601 start published date + --to DATE ISO 8601 end published date + --location CC Two-letter country code for geo-bias +``` + +### contents — Fetch page contents +```bash +cli-anything-exa contents [url ...] [--content text|highlights|summary] [--freshness smart|always|never] +``` + +### server status — Verify API key and connectivity +```bash +cli-anything-exa server status +``` + +## JSON Output +All commands support `--json` at the root level for machine-readable output: +```bash +cli-anything-exa --json search "latest LLM papers" --num-results 5 +``` + +## Common Agent Patterns + +### Fast keyword lookup +```bash +cli-anything-exa --json search "site:arxiv.org transformer architectures" --type fast --content highlights +``` + +### Deep research on a topic +```bash +cli-anything-exa --json search "EU AI Act compliance requirements 2024" --type deep --content text +``` + +### Academic paper discovery +```bash +cli-anything-exa --json search "retrieval augmented generation" --category research-paper --num-results 20 +``` + +### Company intelligence +```bash +cli-anything-exa --json search "Anthropic funding history" --category company +``` + +### News monitoring +```bash +cli-anything-exa --json search "AI regulation news" --category news --from 2024-01-01 +``` + +### Fetch full content for summarisation +```bash +cli-anything-exa --json contents https://example.com/article --content text +``` + +## Interactive REPL +```bash +cli-anything-exa # No subcommand → enters REPL +``` +Type commands without the `cli-anything-exa` prefix. Type `exit` or `quit` to leave. + +## Notes +- `highlights` content mode is 10× more token-efficient than `text` — prefer it for agent pipelines +- `--type deep` triggers multi-step reasoning; slower but synthesises across many sources +- `--category company` and `--category people` do not support date or domain-exclude filters +- Cost per query is included in JSON output under `cost_dollars` diff --git a/skills/cli-anything-freecad/SKILL.md b/skills/cli-anything-freecad/SKILL.md new file mode 100644 index 000000000..58d4a3451 --- /dev/null +++ b/skills/cli-anything-freecad/SKILL.md @@ -0,0 +1,255 @@ +--- +name: "cli-anything-freecad" +description: "Complete CLI harness for FreeCAD parametric 3D CAD modeler (258 commands). Covers ALL workbenches: Part (29 primitives + boolean + mirror + loft + sweep), Sketcher (26 cmds: geometry + constraints + editing), PartDesign (38 cmds: pad/pocket/groove/fillet/chamfer/patterns/hole/datum), Assembly (11 cmds), Mesh (16 cmds), TechDraw (15 cmds: views + dimensions + PDF/SVG), Draft (33 cmds: 2D shapes + arrays + transforms), FEM (12 cmds), CAM/CNC (10 cmds), Surface (6 cmds), Spreadsheet (7 cmds), Import (13 formats), Export (17 formats), Measure (12 cmds), Materials (21 presets). Headless FreeCAD export to STEP/IGES/STL/OBJ/DXF/PDF/glTF/3MF." +--- + +# cli-anything-freecad + +Complete CLI harness for **FreeCAD** — 258 commands across 17 groups covering ALL workbenches. + +## Prerequisites + +FreeCAD must be installed: `freecadcmd` must be in PATH. + +## Installation + +```bash +pip install -e freecad/agent-harness +``` + +## Basic Usage + +```bash +cli-anything-freecad --json # JSON output for agents +cli-anything-freecad --json -p proj.json # With project file +cli-anything-freecad # Interactive REPL +``` + +## Command Groups (258 commands) + +### document (5) — Document management +```bash +cli-anything-freecad --json document new --name "Part" -o proj.json +cli-anything-freecad --json document new --profile print3d -o proj.json +cli-anything-freecad --json -p proj.json document info +cli-anything-freecad --json -p proj.json document save -o copy.json +cli-anything-freecad --json document profiles +``` + +### part (29) — 3D primitives, boolean, transforms, operations +```bash +# Primitives: box, cylinder, sphere, cone, torus, wedge, helix, spiral, thread, plane, polygon_3d +cli-anything-freecad --json -p p.json part add box -P length=20 -P width=15 -P height=5 +cli-anything-freecad --json -p p.json part add cylinder -P radius=3 -P height=10 --position 10,7.5,0 + +# Operations +cli-anything-freecad --json -p p.json part boolean cut 0 1 +cli-anything-freecad --json -p p.json part copy 0 +cli-anything-freecad --json -p p.json part mirror 0 --plane XY +cli-anything-freecad --json -p p.json part scale 0 --factor 2.0 +cli-anything-freecad --json -p p.json part loft --indices 0,1,2 +cli-anything-freecad --json -p p.json part sweep 0 1 +cli-anything-freecad --json -p p.json part revolve 0 --axis Z --angle 360 +cli-anything-freecad --json -p p.json part extrude 0 --direction 0,0,1 --length 10 +cli-anything-freecad --json -p p.json part fillet-3d 0 --radius 2 +cli-anything-freecad --json -p p.json part thickness 0 --thickness 1 +cli-anything-freecad --json -p p.json part compound --indices 0,1,2 +cli-anything-freecad --json -p p.json part section 0 --plane XY +cli-anything-freecad --json -p p.json part info 0 +cli-anything-freecad --json -p p.json part line-3d --start 0,0,0 --end 10,5,0 +cli-anything-freecad --json -p p.json part wire --points "0,0,0;10,0,0;10,10,0" +``` + +### sketch (26) — 2D constrained sketching +```bash +cli-anything-freecad --json -p p.json sketch new --plane XY +cli-anything-freecad --json -p p.json sketch add-line 0 --start 0,0 --end 20,0 +cli-anything-freecad --json -p p.json sketch add-circle 0 --center 10,10 --radius 5 +cli-anything-freecad --json -p p.json sketch add-rect 0 --corner 0,0 --width 20 --height 15 +cli-anything-freecad --json -p p.json sketch add-arc 0 --center 0,0 --radius 5 +cli-anything-freecad --json -p p.json sketch add-ellipse 0 --center 0,0 --major-radius 10 --minor-radius 5 +cli-anything-freecad --json -p p.json sketch add-polygon 0 --center 0,0 --sides 6 --radius 10 +cli-anything-freecad --json -p p.json sketch add-bspline 0 --points "0,0;5,10;10,0;15,10" +cli-anything-freecad --json -p p.json sketch add-slot 0 --center1 0,0 --center2 10,0 --radius 2 +cli-anything-freecad --json -p p.json sketch constrain 0 distance --elements 0,1 --value 10 +cli-anything-freecad --json -p p.json sketch edit-element 0 0 --radius 8 +cli-anything-freecad --json -p p.json sketch remove-element 0 2 +cli-anything-freecad --json -p p.json sketch validate 0 +cli-anything-freecad --json -p p.json sketch solve-status 0 +# Constraints: coincident, horizontal, vertical, parallel, perpendicular, equal, +# fixed, distance, angle, radius, tangent, symmetric, block, diameter, +# point_on_object, distance_x, distance_y +``` + +### body (38) — PartDesign features +```bash +cli-anything-freecad --json -p p.json body new +cli-anything-freecad --json -p p.json body pad 0 0 --length 10 +cli-anything-freecad --json -p p.json body pocket 0 1 --length 5 +cli-anything-freecad --json -p p.json body groove 0 0 --angle 360 +cli-anything-freecad --json -p p.json body fillet 0 --radius 2 +cli-anything-freecad --json -p p.json body chamfer 0 --size 1.5 +cli-anything-freecad --json -p p.json body revolution 0 0 --angle 360 +cli-anything-freecad --json -p p.json body additive-loft 0 --sketch-indices 0,1 +cli-anything-freecad --json -p p.json body additive-pipe 0 0 1 +cli-anything-freecad --json -p p.json body additive-helix 0 0 --pitch 5 --height 20 +cli-anything-freecad --json -p p.json body additive-box 0 -P length=10 -P width=10 -P height=10 +cli-anything-freecad --json -p p.json body hole 0 0 --diameter 5 --depth 10 --threaded +cli-anything-freecad --json -p p.json body draft-feature 0 --angle 5 +cli-anything-freecad --json -p p.json body thickness-feature 0 --thickness 1 +cli-anything-freecad --json -p p.json body linear-pattern 0 --occurrences 5 --length 50 +cli-anything-freecad --json -p p.json body polar-pattern 0 --occurrences 6 --angle 360 +cli-anything-freecad --json -p p.json body mirrored 0 --plane XY +cli-anything-freecad --json -p p.json body datum-plane 0 --reference XY --offset 10 +``` + +### material (8) — PBR materials with engineering properties +```bash +# 21 presets: steel, aluminum, copper, brass, titanium, stainless_steel, cast_iron, +# carbon_fiber, nylon, abs, pla, petg, plastic_white, plastic_black, wood, glass, +# rubber, gold, concrete, granite, marble +cli-anything-freecad --json -p p.json material create --preset steel +cli-anything-freecad --json -p p.json material create --preset titanium +cli-anything-freecad --json -p p.json material assign 0 0 +cli-anything-freecad --json -p p.json material set 0 density 7800 +cli-anything-freecad --json -p p.json material import-material mat.json +cli-anything-freecad --json -p p.json material export-material 0 --output mat.json +``` + +### assembly (11) — Assembly management +```bash +cli-anything-freecad --json -p p.json assembly new --name "MyAssembly" +cli-anything-freecad --json -p p.json assembly add-part 0 0 +cli-anything-freecad --json -p p.json assembly constrain 0 coincident --components 0,1 +cli-anything-freecad --json -p p.json assembly constrain 0 distance --components 0,1 --distance 10 +cli-anything-freecad --json -p p.json assembly solve 0 +cli-anything-freecad --json -p p.json assembly dof 0 +cli-anything-freecad --json -p p.json assembly bom 0 +cli-anything-freecad --json -p p.json assembly explode 0 --factor 2.0 +# Constraints: fixed, coincident, distance, angle, parallel, perpendicular, +# tangent, revolute, prismatic, cylindrical, ball, planar, gear, belt +``` + +### mesh (16) — Mesh operations +```bash +cli-anything-freecad --json -p p.json mesh from-shape 0 --deviation 0.1 +cli-anything-freecad --json -p p.json mesh import path/to/model.stl +cli-anything-freecad --json -p p.json mesh export 0 output.stl --format stl +cli-anything-freecad --json -p p.json mesh boolean union 0 1 +cli-anything-freecad --json -p p.json mesh decimate 0 --target-faces 1000 +cli-anything-freecad --json -p p.json mesh smooth 0 --iterations 5 +cli-anything-freecad --json -p p.json mesh repair 0 +cli-anything-freecad --json -p p.json mesh to-shape 0 +``` + +### techdraw (15) — Technical drawings +```bash +cli-anything-freecad --json -p p.json techdraw new-page +cli-anything-freecad --json -p p.json techdraw add-view 0 0 --direction 0,0,1 --scale 1.0 +cli-anything-freecad --json -p p.json techdraw add-projection-group 0 0 +cli-anything-freecad --json -p p.json techdraw add-section-view 0 0 +cli-anything-freecad --json -p p.json techdraw add-dimension 0 0 length --references 0,1 +cli-anything-freecad --json -p p.json techdraw add-annotation 0 "Note text" +cli-anything-freecad --json -p p.json techdraw export-pdf 0 drawing.pdf +cli-anything-freecad --json -p p.json techdraw export-svg 0 drawing.svg +``` + +### draft (33) — 2D drafting +```bash +cli-anything-freecad --json -p p.json draft wire --points "0,0,0;10,0,0;10,10,0" +cli-anything-freecad --json -p p.json draft rectangle --width 20 --height 15 +cli-anything-freecad --json -p p.json draft circle --radius 10 +cli-anything-freecad --json -p p.json draft polygon --sides 6 --radius 10 +cli-anything-freecad --json -p p.json draft text --content "Hello" --position 0,0,0 +cli-anything-freecad --json -p p.json draft move 0 --vector 10,5,0 +cli-anything-freecad --json -p p.json draft array-linear 0 --direction 1,0,0 --count 5 --spacing 10 +cli-anything-freecad --json -p p.json draft array-polar 0 --center 0,0,0 --count 6 +cli-anything-freecad --json -p p.json draft extrude 0 --direction 0,0,1 --length 10 +cli-anything-freecad --json -p p.json draft to-sketch 0 +``` + +### measure (12) — Measurement and analysis +```bash +cli-anything-freecad --json -p p.json measure volume 0 +cli-anything-freecad --json -p p.json measure area 0 +cli-anything-freecad --json -p p.json measure distance 0 1 +cli-anything-freecad --json -p p.json measure bounding-box 0 +cli-anything-freecad --json -p p.json measure center-of-mass 0 +cli-anything-freecad --json -p p.json measure check-geometry 0 +``` + +### surface (6) — Surface operations +```bash +cli-anything-freecad --json -p p.json surface filling --edges 0,1,2 +cli-anything-freecad --json -p p.json surface sections --sections 0,1,2 +cli-anything-freecad --json -p p.json surface extend 0 --length 10 +cli-anything-freecad --json -p p.json surface sew --indices 0,1 +``` + +### fem (12) — Finite Element Analysis +```bash +cli-anything-freecad --json -p p.json fem new-analysis +cli-anything-freecad --json -p p.json fem add-fixed 0 --references face1,face2 +cli-anything-freecad --json -p p.json fem add-force 0 --references face3 --magnitude 1000 +cli-anything-freecad --json -p p.json fem set-material 0 0 +cli-anything-freecad --json -p p.json fem mesh-generate 0 --max-size 5 +cli-anything-freecad --json -p p.json fem solve 0 +cli-anything-freecad --json -p p.json fem results 0 +``` + +### cam (10) — CNC machining +```bash +cli-anything-freecad --json -p p.json cam new-job 0 +cli-anything-freecad --json -p p.json cam set-stock 0 --stock-type box +cli-anything-freecad --json -p p.json cam set-tool 0 --diameter 6 --type endmill +cli-anything-freecad --json -p p.json cam add-profile 0 +cli-anything-freecad --json -p p.json cam add-pocket 0 --depth 5 +cli-anything-freecad --json -p p.json cam generate-gcode 0 +cli-anything-freecad --json -p p.json cam export-gcode 0 output.nc +``` + +### spreadsheet (7) — Parametric data tables +```bash +cli-anything-freecad --json -p p.json spreadsheet new +cli-anything-freecad --json -p p.json spreadsheet set-cell 0 A1 "50" +cli-anything-freecad --json -p p.json spreadsheet set-cell 0 B1 "=A1*2" +cli-anything-freecad --json -p p.json spreadsheet set-alias 0 A1 plate_width +cli-anything-freecad --json -p p.json spreadsheet export-csv 0 data.csv +``` + +### import (13) — Import CAD/mesh files +```bash +cli-anything-freecad --json -p p.json import auto model.step +cli-anything-freecad --json -p p.json import step model.step +cli-anything-freecad --json -p p.json import stl model.stl +cli-anything-freecad --json -p p.json import dxf drawing.dxf +cli-anything-freecad --json -p p.json import info model.step +# Formats: step, iges, stl, obj, dxf, svg, brep, 3mf, ply, off, gltf +``` + +### export (3) — Export to 17 formats +```bash +# Presets: step, iges, stl, stl_fine, obj, brep, fcstd, dxf, svg, gltf, 3mf, ply, off, amf, pdf, png, jpg +cli-anything-freecad --json -p p.json export render output.step --preset step +cli-anything-freecad --json -p p.json export render model.stl --preset stl --overwrite +cli-anything-freecad --json -p p.json export presets +``` + +### session (4) — Undo/redo +```bash +cli-anything-freecad --json -p p.json session undo +cli-anything-freecad --json -p p.json session redo +cli-anything-freecad --json -p p.json session status +cli-anything-freecad --json -p p.json session history +``` + +## JSON Output + +All commands support `--json`. Responses include structured data. Errors: `{"error": "message"}`. + +## Error Handling + +- Missing FreeCAD: Clear install instructions +- Invalid types: Lists valid options +- Index out of range: Reports valid range +- File exists: Use `--overwrite` diff --git a/skills/cli-anything-gimp/SKILL.md b/skills/cli-anything-gimp/SKILL.md new file mode 100644 index 000000000..d2f698c56 --- /dev/null +++ b/skills/cli-anything-gimp/SKILL.md @@ -0,0 +1,237 @@ +--- +name: "cli-anything-gimp" +description: >- + Command-line interface for Gimp - A stateful command-line interface for image editing, built on Pillow. Designed for AI agents and pow... +--- + +# cli-anything-gimp + +A stateful command-line interface for image editing, built on Pillow. Designed for AI agents and power users who need to create and manipulate images without a GUI. + +## Installation + +This CLI is installed as part of the cli-anything-gimp package: + +```bash +pip install cli-anything-gimp +``` + +**Prerequisites:** +- Python 3.10+ +- gimp must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-gimp --help + +# Start interactive REPL mode +cli-anything-gimp + +# Create a new project +cli-anything-gimp project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-gimp --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-gimp +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management commands. + +| Command | Description | +|---------|-------------| +| `new` | Create a new project | +| `open` | Open an existing project | +| `save` | Save the current project | +| `info` | Show project information | +| `profiles` | List available canvas profiles | +| `json` | Print raw project JSON | + + +### Layer + +Layer management commands. + +| Command | Description | +|---------|-------------| +| `new` | Create a new blank layer | +| `add-from-file` | Add a layer from an image file | +| `list` | List all layers | +| `remove` | Remove a layer by index | +| `duplicate` | Duplicate a layer | +| `move` | Move a layer to a new position | +| `set` | Set a layer property (name, opacity, visible, mode, offset_x, offset_y) | +| `flatten` | Flatten all visible layers | +| `merge-down` | Merge a layer with the one below it | + + +### Canvas + +Canvas operations. + +| Command | Description | +|---------|-------------| +| `info` | Show canvas information | +| `resize` | Resize the canvas (without scaling content) | +| `scale` | Scale the canvas and all content proportionally | +| `crop` | Crop the canvas to a rectangle | +| `mode` | Set the canvas color mode | +| `dpi` | Set the canvas DPI | + + +### Filter Group + +Filter management commands. + +| Command | Description | +|---------|-------------| +| `list-available` | List all available filters | +| `info` | Show details about a filter | +| `add` | Add a filter to a layer | +| `remove` | Remove a filter by index | +| `set` | Set a filter parameter | +| `list` | List filters on a layer | + + +### Media + +Media file operations. + +| Command | Description | +|---------|-------------| +| `probe` | Analyze an image file | +| `list` | List media files referenced in the project | +| `check` | Check that all referenced media files exist | +| `histogram` | Show histogram analysis of an image | + + +### Export Group + +Export/render commands. + +| Command | Description | +|---------|-------------| +| `presets` | List export presets | +| `preset-info` | Show preset details | +| `render` | Render the project to an image file | + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| +| `status` | Show session status | +| `undo` | Undo the last operation | +| `redo` | Redo the last undone operation | +| `history` | Show undo history | + + +### Draw + +Drawing operations (applied at render time). + +| Command | Description | +|---------|-------------| +| `text` | Draw text on a layer (by converting it to a text layer) | +| `rect` | Draw a rectangle (stored as drawing operation) | + + + + +## Examples + + +### Create a New Project + +Create a new gimp project file. + +```bash +cli-anything-gimp project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-gimp --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-gimp +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-gimp --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-gimp project info -p project.json + +# JSON output for agents +cli-anything-gimp --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/skills/cli-anything-godot/SKILL.md b/skills/cli-anything-godot/SKILL.md new file mode 100644 index 000000000..bf48161e2 --- /dev/null +++ b/skills/cli-anything-godot/SKILL.md @@ -0,0 +1,106 @@ +--- +name: "cli-anything-godot" +description: >- + Agent-native CLI for Godot project management, scenes, exports, and script execution. +--- + +# Godot Engine CLI + +Agent-native CLI for the Godot game engine. Manage projects, scenes, exports, and GDScript execution from the command line. + +## Installation + +```bash +pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness +``` + +## Requirements + +- Godot 4.x on PATH (or set GODOT_BIN env var) + +## Commands + +### Project Management + +```bash +# Create a new Godot project +cli-anything-godot project create [--name "My Game"] + +# Get project info (name, features, main scene) +cli-anything-godot --json -p project info + +# List all scenes +cli-anything-godot --json -p project scenes + +# List all scripts +cli-anything-godot --json -p project scripts + +# List all resources +cli-anything-godot --json -p project resources + +# Re-import project resources +cli-anything-godot -p project reimport +``` + +### Scene Operations + +```bash +# Create a new scene with root node type +cli-anything-godot -p scene create scenes/Level1.tscn --root-type Node3D + +# Read scene structure (nodes, resources, connections) +cli-anything-godot --json -p scene read scenes/Level1.tscn + +# Add a child node to a scene +cli-anything-godot -p scene add-node scenes/Level1.tscn --name Player --type CharacterBody3D --parent . +``` + +### GDScript Execution + +```bash +# Run a GDScript file (must extend SceneTree) +cli-anything-godot -p script run tools/build_navmesh.gd + +# Run inline GDScript code +cli-anything-godot -p script inline 'print(ProjectSettings.get_setting("application/config/name"))' + +# Validate GDScript syntax +cli-anything-godot -p script validate scripts/player.gd +``` + +### Export + +```bash +# List configured export presets +cli-anything-godot --json -p export presets + +# Export all presets +cli-anything-godot -p export build + +# Export a specific preset +cli-anything-godot -p export build --preset "Windows Desktop" --output build/game.exe +``` + +### Engine + +```bash +# Check Godot availability and binary path +cli-anything-godot --json engine status + +# Get engine version +cli-anything-godot engine version +``` + +## JSON Mode + +Add `--json` flag to any command for structured JSON output suitable for agent consumption: + +```bash +cli-anything-godot --json -p ./my-game project info +``` + +## Interactive REPL + +```bash +cli-anything-godot -p ./my-game session +``` diff --git a/skills/cli-anything-inkscape/SKILL.md b/skills/cli-anything-inkscape/SKILL.md new file mode 100644 index 000000000..1978b43a7 --- /dev/null +++ b/skills/cli-anything-inkscape/SKILL.md @@ -0,0 +1,273 @@ +--- +name: "cli-anything-inkscape" +description: >- + Command-line interface for Inkscape - A stateful command-line interface for vector graphics editing, following the same patterns as the GI... +--- + +# cli-anything-inkscape + +A stateful command-line interface for vector graphics editing, following the same patterns as the GIMP and Blender CLI harnesses. Directly manipulates SVG (XML) documents with a JSON project format for state tracking. + +## Installation + +This CLI is installed as part of the cli-anything-inkscape package: + +```bash +pip install cli-anything-inkscape +``` + +**Prerequisites:** +- Python 3.10+ +- inkscape must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-inkscape --help + +# Start interactive REPL mode +cli-anything-inkscape + +# Create a new project +cli-anything-inkscape project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-inkscape --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-inkscape +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Document + +Document management commands. + +| Command | Description | +|---------|-------------| +| `new` | Create a new document | +| `open` | Open an existing project | +| `save` | Save the current project | +| `info` | Show document information | +| `profiles` | List available document profiles | +| `canvas-size` | Set the canvas size | +| `units` | Set the document units | +| `json` | Print raw project JSON | + + +### Shape + +Shape management commands. + +| Command | Description | +|---------|-------------| +| `add-rect` | Add a rectangle | +| `add-circle` | Add a circle | +| `add-ellipse` | Add an ellipse | +| `add-line` | Add a line | +| `add-polygon` | Add a polygon | +| `add-path` | Add a path | +| `add-star` | Add a star | +| `remove` | Remove a shape by index | +| `duplicate` | Duplicate a shape | +| `list` | List all shapes/objects | +| `get` | Get detailed info about a shape | + + +### Text + +Text management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a text element | +| `set` | Set a text property (text, font-family, font-size, fill, etc.) | +| `list` | List all text objects | + + +### Style + +Style management commands. + +| Command | Description | +|---------|-------------| +| `set-fill` | Set the fill color of an object | +| `set-stroke` | Set the stroke color (and optionally width) of an object | +| `set-opacity` | Set the opacity of an object (0.0-1.0) | +| `set` | Set an arbitrary style property on an object | +| `get` | Get the style properties of an object | +| `list-properties` | List all available style properties | + + +### Transform + +Transform operations (translate, rotate, scale, skew). + +| Command | Description | +|---------|-------------| +| `translate` | Translate (move) an object | +| `rotate` | Rotate an object | +| `scale` | Scale an object | +| `skew-x` | Skew an object horizontally | +| `skew-y` | Skew an object vertically | +| `get` | Get the current transform of an object | +| `clear` | Clear all transforms from an object | + + +### Layer + +Layer management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a new layer | +| `remove` | Remove a layer by index | +| `move-object` | Move an object to a different layer | +| `set` | Set a layer property (name, visible, locked, opacity) | +| `list` | List all layers | +| `reorder` | Move a layer from one position to another | +| `get` | Get detailed info about a layer | + + +### Path Group + +Path boolean operations. + +| Command | Description | +|---------|-------------| +| `union` | Union of two objects | +| `intersection` | Intersection of two objects | +| `difference` | Difference of two objects (A minus B) | +| `exclusion` | Exclusion (XOR) of two objects | +| `convert` | Convert a shape to a path | +| `list-operations` | List available path boolean operations | + + +### Gradient + +Gradient management commands. + +| Command | Description | +|---------|-------------| +| `add-linear` | Add a linear gradient | +| `add-radial` | Add a radial gradient | +| `apply` | Apply a gradient to an object | +| `list` | List all gradients | + + +### Export Group + +Export/render commands. + +| Command | Description | +|---------|-------------| +| `png` | Render the document to PNG | +| `svg` | Export the document as SVG | +| `pdf` | Export the document as PDF (requires Inkscape) | +| `presets` | List export presets | + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| +| `status` | Show session status | +| `undo` | Undo the last operation | +| `redo` | Redo the last undone operation | +| `history` | Show undo history | + + + + +## Examples + + +### Create a New Project + +Create a new inkscape project file. + +```bash +cli-anything-inkscape project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-inkscape --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-inkscape +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-inkscape --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-inkscape project info -p project.json + +# JSON output for agents +cli-anything-inkscape --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/skills/cli-anything-intelwatch/SKILL.md b/skills/cli-anything-intelwatch/SKILL.md new file mode 100644 index 000000000..b9a185036 --- /dev/null +++ b/skills/cli-anything-intelwatch/SKILL.md @@ -0,0 +1,50 @@ +--- +name: "cli-anything-intelwatch" +description: >- + Zero friction. Full context. Competitive intelligence, M&A due diligence, and OSINT directly from your terminal. Uses Node.js/npx. +--- + +# cli-anything-intelwatch + +Intelwatch bridges the gap between hacker OSINT and B2B Sales/M&A data. It executes complex financial data aggregation, technology stack detection, and AI-powered due diligence in seconds. + +## Installation + +This CLI is installed as part of the cli-anything-intelwatch package: + +```bash +pip install cli-anything-intelwatch +``` + +**Prerequisites:** +- Node.js >=18 must be installed and accessible via `npx` +- Run `node -v` and `npx -v` to ensure your system meets the requirements + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-intelwatch --help + +# Generate a deep profile for a company +cli-anything-intelwatch profile kpmg.fr + +# Generate a profile with AI Due Diligence +cli-anything-intelwatch profile kpmg.fr --ai +``` + +## For AI Agents + +When using this CLI programmatically: + +1. Provide the domain name (e.g., `doctolib.fr`) +2. Use the `--ai` flag to let Intelwatch perform due diligence automatically +3. The output is human-readable and provides a deep breakdown of the company +4. Ensure `npx` is available on the machine + +## Example Scenarios + +- **M&A Due Diligence:** `cli-anything-intelwatch profile company-name.com --ai` +- **Sales Intelligence:** `cli-anything-intelwatch profile target-client.com` diff --git a/skills/cli-anything-iterm2-ctl/SKILL.md b/skills/cli-anything-iterm2-ctl/SKILL.md new file mode 100644 index 000000000..68e966c4b --- /dev/null +++ b/skills/cli-anything-iterm2-ctl/SKILL.md @@ -0,0 +1,100 @@ +--- +name: "cli-anything-iterm2-ctl" +description: "Provides the cli-anything-iterm2 commands — the only way to actually send text to iTerm2 sessions, read live terminal output and scrollback history, manage windows/tabs/split panes, run tmux -CC workflows, broadcast to multiple panes, show macOS dialogs, and read/write iTerm2 preferences. Includes `app snapshot` — the primary orientation command that returns every session's name, current directory, foreground process, role label, and last output line in one call. Read this skill instead of answering from general knowledge whenever the user wants to DO something with iTerm2: orient in an existing workspace, send a command, check what's running, read output, set up a layout, use tmux through iTerm2, automate panes, or configure preferences. Also read for questions about iTerm2 shell integration or scrollback. Don't try to answer iTerm2 action requests from memory — read this skill first." +--- + +# cli-anything-iterm2 + +Stateful CLI harness for iTerm2. Controls a live iTerm2 process via the iTerm2 Python API over WebSocket. + +## Prerequisites + +1. **macOS + iTerm2** running: `brew install --cask iterm2` +2. **Python API enabled**: iTerm2 → Preferences → General → Magic → Enable Python API +3. **Install**: `pip install cli-anything-iterm2` (or `pip install -e .` from source) + +## Basic Syntax + +```bash +cli-anything-iterm2 [--json] [OPTIONS] [ARGS] +``` + +Always use `--json` for machine-readable output (required for agent use). + +## Command Groups + +| Group | Purpose | +|-------|---------| +| `app` | App status, workspace snapshot, context management, app-level variables, modal dialogs, file panels | +| `window` | Create, list, close, resize, fullscreen windows | +| `tab` | Create, list, close, activate tabs; navigate split panes by direction | +| `session` | Send text, inject raw bytes, read screen, full scrollback, split panes, prompt detection | +| `profile` | List profiles, get profile details, list/apply color presets | +| `arrangement` | Save and restore window layouts | +| `tmux` | Full tmux -CC integration: bootstrap, connections, windows, commands | +| `broadcast` | Sync keystrokes across panes via broadcast domains | +| `menu` | Invoke any iTerm2 menu item programmatically | +| `pref` | Read/write global iTerm2 preferences; list all valid keys; tmux settings | + +## Orienting in an Existing Workspace + +Use `app snapshot` when you land in a session with existing panes and need to understand what's running without reading full screen contents for each pane: + +```bash +cli-anything-iterm2 --json app snapshot +``` + +Returns name, current directory, foreground process, `user.role` label, and last visible output line for every session across all windows. + +**Naming convention** — label panes when setting up a workspace so you can find them later: +```bash +cli-anything-iterm2 session set-var user.role "api-server" +cli-anything-iterm2 session set-var user.role "log-tail" +cli-anything-iterm2 session set-var user.role "editor" +``` +`app snapshot` will surface these roles alongside process and path, giving you a full picture in one call. + +## Typical Agent Workflow + +```bash +# 1. Orient — snapshot every session: name, path, process, role, last output line +cli-anything-iterm2 --json app snapshot + +# 2. Establish context (saves window/tab/session IDs for subsequent commands) +cli-anything-iterm2 app current + +# 3. Interact — no --session-id needed once context is set +cli-anything-iterm2 session send "git status" +cli-anything-iterm2 --json session scrollback --tail 200 --strip + +# 4. Create a multi-pane workspace — label panes so snapshot identifies them later +cli-anything-iterm2 session split --vertical --use-as-context +cli-anything-iterm2 session send "python3 -m http.server 8000" +cli-anything-iterm2 session set-var user.role "http-server" +``` + +## Reference Files + +Read only what the task requires — each file is a single narrow concern (~10–30 lines): + +| File | Read when you need... | +|------|-----------------------| +| `references/session-io.md` | Send text, inject bytes, read screen/scrollback, get selection | +| `references/session-control.md` | Split panes, activate/close sessions, resize, rename, session variables | +| `references/session-shell-integration.md` | wait-prompt, wait-command-end, get-prompt; reliable send→wait→read pattern | +| `references/layout-window-tab.md` | Create/close/resize windows and tabs, navigate split panes | +| `references/layout-arrangement.md` | Save and restore window layouts | +| `references/app-context.md` | **Snapshot** (orientation), status, context management, app vars, modal dialogs, file panels | +| `references/profile-pref.md` | Profiles list/get/presets, preferences read/write, tmux pref shortcuts | +| `references/broadcast-menu.md` | Broadcast keystrokes to multiple panes, invoke menu items | +| `references/tmux-commands.md` | All tmux CLI commands (bootstrap, send, tabs, create-window, set-visible) | +| `references/tmux-guide.md` | Full tmux -CC workflow, pane→session ID mapping | +| `references/json-session.md` | `--json` schemas for session, window, tab, screen, scrollback, inject | +| `references/json-tmux-app.md` | `--json` schemas for tmux, app dialogs, preferences, errors | + +## REPL Mode + +Run without arguments for an interactive REPL that maintains context between commands: +```bash +cli-anything-iterm2 +``` diff --git a/skills/cli-anything-iterm2/SKILL.md b/skills/cli-anything-iterm2/SKILL.md new file mode 100644 index 000000000..b82c4395b --- /dev/null +++ b/skills/cli-anything-iterm2/SKILL.md @@ -0,0 +1,100 @@ +--- +name: "cli-anything-iterm2" +description: "Provides the cli-anything-iterm2 commands — the only way to actually send text to iTerm2 sessions, read live terminal output and scrollback history, manage windows/tabs/split panes, run tmux -CC workflows, broadcast to multiple panes, show macOS dialogs, and read/write iTerm2 preferences. Includes `app snapshot` — the primary orientation command that returns every session's name, current directory, foreground process, role label, and last output line in one call. Read this skill instead of answering from general knowledge whenever the user wants to DO something with iTerm2: orient in an existing workspace, send a command, check what's running, read output, set up a layout, use tmux through iTerm2, automate panes, or configure preferences. Also read for questions about iTerm2 shell integration or scrollback. Don't try to answer iTerm2 action requests from memory — read this skill first." +--- + +# cli-anything-iterm2 + +Stateful CLI harness for iTerm2. Controls a live iTerm2 process via the iTerm2 Python API over WebSocket. + +## Prerequisites + +1. **macOS + iTerm2** running: `brew install --cask iterm2` +2. **Python API enabled**: iTerm2 → Preferences → General → Magic → Enable Python API +3. **Install**: `pip install cli-anything-iterm2` (or `pip install -e .` from source) + +## Basic Syntax + +```bash +cli-anything-iterm2 [--json] [OPTIONS] [ARGS] +``` + +Always use `--json` for machine-readable output (required for agent use). + +## Command Groups + +| Group | Purpose | +|-------|---------| +| `app` | App status, workspace snapshot, context management, app-level variables, modal dialogs, file panels | +| `window` | Create, list, close, resize, fullscreen windows | +| `tab` | Create, list, close, activate tabs; navigate split panes by direction | +| `session` | Send text, inject raw bytes, read screen, full scrollback, split panes, prompt detection | +| `profile` | List profiles, get profile details, list/apply color presets | +| `arrangement` | Save and restore window layouts | +| `tmux` | Full tmux -CC integration: bootstrap, connections, windows, commands | +| `broadcast` | Sync keystrokes across panes via broadcast domains | +| `menu` | Invoke any iTerm2 menu item programmatically | +| `pref` | Read/write global iTerm2 preferences; list all valid keys; tmux settings | + +## Orienting in an Existing Workspace + +Use `app snapshot` when you land in a session with existing panes and need to understand what's running without reading full screen contents for each pane: + +```bash +cli-anything-iterm2 --json app snapshot +``` + +Returns name, current directory, foreground process, `user.role` label, and last visible output line for every session across all windows. + +**Naming convention** — label panes when setting up a workspace so you can find them later: +```bash +cli-anything-iterm2 session set-var user.role "api-server" +cli-anything-iterm2 session set-var user.role "log-tail" +cli-anything-iterm2 session set-var user.role "editor" +``` +`app snapshot` will surface these roles alongside process and path, giving you a full picture in one call. + +## Typical Agent Workflow + +```bash +# 1. Orient — snapshot every session: name, path, process, role, last output line +cli-anything-iterm2 --json app snapshot + +# 2. Establish context (saves window/tab/session IDs for subsequent commands) +cli-anything-iterm2 app current + +# 3. Interact — no --session-id needed once context is set +cli-anything-iterm2 session send "git status" +cli-anything-iterm2 --json session scrollback --tail 200 --strip + +# 4. Create a multi-pane workspace — label panes so snapshot identifies them later +cli-anything-iterm2 session split --vertical --use-as-context +cli-anything-iterm2 session send "python3 -m http.server 8000" +cli-anything-iterm2 session set-var user.role "http-server" +``` + +## Reference Files + +Read only what the task requires — each file is a single narrow concern (~10–30 lines): + +| File | Read when you need... | +|------|-----------------------| +| `references/session-io.md` | Send text, inject bytes, read screen/scrollback, get selection | +| `references/session-control.md` | Split panes, activate/close sessions, resize, rename, session variables | +| `references/session-shell-integration.md` | wait-prompt, wait-command-end, get-prompt; reliable send→wait→read pattern | +| `references/layout-window-tab.md` | Create/close/resize windows and tabs, navigate split panes | +| `references/layout-arrangement.md` | Save and restore window layouts | +| `references/app-context.md` | **Snapshot** (orientation), status, context management, app vars, modal dialogs, file panels | +| `references/profile-pref.md` | Profiles list/get/presets, preferences read/write, tmux pref shortcuts | +| `references/broadcast-menu.md` | Broadcast keystrokes to multiple panes, invoke menu items | +| `references/tmux-commands.md` | All tmux CLI commands (bootstrap, send, tabs, create-window, set-visible) | +| `references/tmux-guide.md` | Full tmux -CC workflow, pane→session ID mapping | +| `references/json-session.md` | `--json` schemas for session, window, tab, screen, scrollback, inject | +| `references/json-tmux-app.md` | `--json` schemas for tmux, app dialogs, preferences, errors | + +## REPL Mode + +Run without arguments for an interactive REPL that maintains context between commands: +```bash +cli-anything-iterm2 +``` diff --git a/skills/cli-anything-kdenlive/SKILL.md b/skills/cli-anything-kdenlive/SKILL.md new file mode 100644 index 000000000..e7347c00d --- /dev/null +++ b/skills/cli-anything-kdenlive/SKILL.md @@ -0,0 +1,233 @@ +--- +name: "cli-anything-kdenlive" +description: >- + Command-line interface for Kdenlive - A stateful command-line interface for video editing, following the same patterns as the Blender CLI ... +--- + +# cli-anything-kdenlive + +A stateful command-line interface for video editing, following the same patterns as the Blender CLI harness. Uses a JSON project format with MLT XML generation for Kdenlive/melt. + +## Installation + +This CLI is installed as part of the cli-anything-kdenlive package: + +```bash +pip install cli-anything-kdenlive +``` + +**Prerequisites:** +- Python 3.10+ +- kdenlive must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-kdenlive --help + +# Start interactive REPL mode +cli-anything-kdenlive + +# Create a new project +cli-anything-kdenlive project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-kdenlive --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-kdenlive +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management commands. + +| Command | Description | +|---------|-------------| +| `new` | Create a new project | +| `open` | Open an existing project | +| `save` | Save the current project | +| `info` | Show project information | +| `profiles` | List available video profiles | +| `json` | Print raw project JSON | + + +### Bin Group + +Media bin management commands. + +| Command | Description | +|---------|-------------| +| `import` | Import a clip into the media bin | +| `remove` | Remove a clip from the bin | +| `list` | List all clips in the bin | +| `get` | Get detailed clip info | + + +### Timeline + +Timeline management commands. + +| Command | Description | +|---------|-------------| +| `add-track` | Add a track to the timeline | +| `remove-track` | Remove a track | +| `add-clip` | Add a clip to a track | +| `remove-clip` | Remove a clip from a track | +| `trim` | Trim a clip's in/out points | +| `split` | Split a clip at a time offset | +| `move` | Move a clip to a new position | +| `list` | List all tracks | + + +### Filter Group + +Filter/effect management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a filter to a clip | +| `remove` | Remove a filter from a clip | +| `set` | Set a filter parameter | +| `list` | List filters on a clip | +| `available` | List all available filters | + + +### Transition + +Transition management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a transition between tracks | +| `remove` | Remove a transition | +| `set` | Set a transition parameter | +| `list` | List all transitions | + + +### Guide + +Guide/marker management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a guide at a position (seconds) | +| `remove` | Remove a guide | +| `list` | List all guides | + + +### Export + +Export and render commands. + +| Command | Description | +|---------|-------------| +| `xml` | Generate Kdenlive/MLT XML | +| `presets` | List available render presets | + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| +| `status` | Show session status | +| `undo` | Undo the last operation | +| `redo` | Redo the last undone operation | +| `history` | Show undo history | + + + + +## Examples + + +### Create a New Project + +Create a new kdenlive project file. + +```bash +cli-anything-kdenlive project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-kdenlive --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-kdenlive +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-kdenlive project info -p project.json + +# JSON output for agents +cli-anything-kdenlive --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/skills/cli-anything-krita/SKILL.md b/skills/cli-anything-krita/SKILL.md new file mode 100644 index 000000000..487872aee --- /dev/null +++ b/skills/cli-anything-krita/SKILL.md @@ -0,0 +1,113 @@ +--- +name: "cli-anything-krita" +description: "CLI harness for Krita digital painting — manage projects, layers, filters, and export via command line. Use when automating Krita workflows, batch processing images, or operating Krita without a GUI." +--- + +# cli-anything-krita + +CLI harness for **Krita**, the professional open-source digital painting application. + +## Prerequisites + +- **Krita** installed on the system +- **Python 3.10+** + +Install the CLI: +```bash +cd krita/agent-harness && pip install -e . +``` + +## Command Reference + +### Project Management +```bash +cli-anything-krita project new -n "My Art" -w 2048 -h 2048 -o project.json +cli-anything-krita project open project.json +cli-anything-krita --project project.json project save +cli-anything-krita --project project.json project info +``` + +### Layer Management +```bash +cli-anything-krita -p project.json layer add "Sketch" -t paintlayer +cli-anything-krita -p project.json layer add "Colors" --opacity 200 +cli-anything-krita -p project.json layer add "Group" -t grouplayer +cli-anything-krita -p project.json layer remove "Sketch" +cli-anything-krita -p project.json layer list +cli-anything-krita -p project.json layer set "Colors" opacity 180 +cli-anything-krita -p project.json layer set "Colors" visible false +cli-anything-krita -p project.json layer set "Colors" blending_mode multiply +``` + +Layer types: `paintlayer`, `grouplayer`, `vectorlayer`, `filterlayer`, `filllayer`, `clonelayer`, `filelayer` + +### Filters +```bash +cli-anything-krita -p project.json filter apply blur -l "Background" +cli-anything-krita -p project.json filter apply sharpen +cli-anything-krita -p project.json filter apply levels -c '{"shadows": 10, "highlights": 240}' +cli-anything-krita filter list +``` + +Available: blur, sharpen, desaturate, levels, curves, brightness-contrast, hue-saturation, color-balance, unsharp-mask, posterize, threshold + +### Canvas Operations +```bash +cli-anything-krita -p project.json canvas resize -w 4096 -h 4096 +cli-anything-krita -p project.json canvas resize --resolution 600 +cli-anything-krita -p project.json canvas info +``` + +### Export +```bash +cli-anything-krita -p project.json export render output.png -p png --overwrite +cli-anything-krita -p project.json export render output.jpg -p jpeg +cli-anything-krita -p project.json export render output.psd -p psd +cli-anything-krita -p project.json export animation ./frames/ -p png +cli-anything-krita export presets +cli-anything-krita export formats +``` + +Presets: png, png-web, jpeg, jpeg-web, jpeg-low, tiff, tiff-lzw, psd, pdf, svg, webp, gif, bmp + +### Session (Undo/Redo) +```bash +cli-anything-krita session undo +cli-anything-krita session redo +cli-anything-krita session history +``` + +### Status +```bash +cli-anything-krita status +``` + +## Agent Usage (JSON Mode) + +All commands support `--json` for machine-readable output: + +```bash +cli-anything-krita --json -p project.json project info +cli-anything-krita --json -p project.json layer list +cli-anything-krita --json status +``` + +## Example Workflow + +```bash +# 1. Create project +cli-anything-krita --json project new -n "Illustration" -w 3000 -h 4000 -o art.json + +# 2. Set up layer stack +cli-anything-krita --json -p art.json layer add "Background" -t paintlayer +cli-anything-krita --json -p art.json layer add "Sketch" -t paintlayer --opacity 180 +cli-anything-krita --json -p art.json layer add "Inking" -t paintlayer +cli-anything-krita --json -p art.json layer add "Colors" -t paintlayer +cli-anything-krita --json -p art.json layer add "Effects" -t paintlayer --opacity 128 + +# 3. Apply effects +cli-anything-krita --json -p art.json filter apply blur -l "Background" + +# 4. Export +cli-anything-krita --json -p art.json export render final.png -p png --overwrite +``` diff --git a/skills/cli-anything-libreoffice/SKILL.md b/skills/cli-anything-libreoffice/SKILL.md new file mode 100644 index 000000000..8ce54509a --- /dev/null +++ b/skills/cli-anything-libreoffice/SKILL.md @@ -0,0 +1,226 @@ +--- +name: "cli-anything-libreoffice" +description: >- + Command-line interface for Libreoffice - A stateful command-line interface for document editing, producing real ODF files (ZIP archives with ... +--- + +# cli-anything-libreoffice + +A stateful command-line interface for document editing, producing real ODF files (ZIP archives with XML). Designed for AI agents and power users who need to create and manipulate Writer, Calc, and Impress documents without a GUI or LibreOffice installation. + +## Installation + +This CLI is installed as part of the cli-anything-libreoffice package: + +```bash +pip install cli-anything-libreoffice +``` + +**Prerequisites:** +- Python 3.10+ +- libreoffice must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-libreoffice --help + +# Start interactive REPL mode +cli-anything-libreoffice + +# Create a new project +cli-anything-libreoffice project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-libreoffice --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-libreoffice +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Document + +Document management commands. + +| Command | Description | +|---------|-------------| +| `new` | Create a new document | +| `open` | Open an existing project file | +| `save` | Save the current document | +| `info` | Show document information | +| `profiles` | List available page profiles | +| `json` | Print raw project JSON | + + +### Writer + +Writer (word processor) commands. + +| Command | Description | +|---------|-------------| +| `add-paragraph` | Add a paragraph to the document | +| `add-heading` | Add a heading to the document | +| `add-list` | Add a list to the document | +| `add-table` | Add a table to the document | +| `add-page-break` | Add a page break | +| `remove` | Remove a content item by index | +| `list` | List all content items | +| `set-text` | Set the text of a content item | + + +### Calc + +Calc (spreadsheet) commands. + +| Command | Description | +|---------|-------------| +| `add-sheet` | Add a new sheet | +| `remove-sheet` | Remove a sheet by index | +| `rename-sheet` | Rename a sheet | +| `set-cell` | Set a cell value | +| `get-cell` | Get a cell value | +| `list-sheets` | List all sheets | + + +### Impress + +Impress (presentation) commands. + +| Command | Description | +|---------|-------------| +| `add-slide` | Add a slide to the presentation | +| `remove-slide` | Remove a slide by index | +| `set-content` | Update a slide's title and/or content | +| `list-slides` | List all slides | +| `add-element` | Add an element to a slide | + + +### Style Group + +Style management commands. + +| Command | Description | +|---------|-------------| +| `create` | Create a new style | +| `modify` | Modify an existing style | +| `list` | List all styles | +| `apply` | Apply a style to a content item (Writer only) | +| `remove` | Remove a style | + + +### Export Group + +Export/render commands. + +| Command | Description | +|---------|-------------| +| `presets` | List export presets | +| `preset-info` | Show preset details | +| `render` | Export the document to a file | + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| +| `status` | Show session status | +| `undo` | Undo the last operation | +| `redo` | Redo the last undone operation | +| `history` | Show undo history | + + + + +## Examples + + +### Create a New Project + +Create a new libreoffice project file. + +```bash +cli-anything-libreoffice project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-libreoffice --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-libreoffice +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-libreoffice --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-libreoffice project info -p project.json + +# JSON output for agents +cli-anything-libreoffice --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/skills/cli-anything-mermaid/SKILL.md b/skills/cli-anything-mermaid/SKILL.md new file mode 100644 index 000000000..1cf8de064 --- /dev/null +++ b/skills/cli-anything-mermaid/SKILL.md @@ -0,0 +1,182 @@ +--- +name: "cli-anything-mermaid" +description: >- + Command-line interface for Mermaid Live Editor - Create, edit, and render Mermaid diagrams via stateful project files and mermaid.ink renderer URLs. Designed for AI agents and power users who need to generate flowcharts, sequence diagrams, and other visualizations without a GUI. +--- + +# cli-anything-mermaid + +Create, edit, and render Mermaid diagrams via stateful project files and the mermaid.ink renderer. Designed for AI agents and power users who need to generate flowcharts, sequence diagrams, and other visualizations without a GUI. + +## Installation + +This CLI is installed as part of the cli-anything-mermaid package: + +```bash +pip install cli-anything-mermaid +``` + +**Prerequisites:** +- Python 3.10+ +- No external software required (rendering uses mermaid.ink cloud service) + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-mermaid --help + +# Start interactive REPL mode +cli-anything-mermaid + +# Create a new project +cli-anything-mermaid project new -o diagram.json + +# Run with JSON output (for agent consumption) +cli-anything-mermaid --json project info +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-mermaid +# Enter commands interactively with tab-completion and history +``` + +## Command Groups + +### Project + +Project lifecycle commands. + +| Command | Description | +|---------|-------------| +| `new` | Create a new Mermaid project with optional sample preset and theme | +| `open` | Open an existing Mermaid project file | +| `save` | Save the current project to a file | +| `info` | Show current project information | +| `samples` | List available sample diagram presets | + +### Diagram + +Diagram source manipulation commands. + +| Command | Description | +|---------|-------------| +| `set` | Replace the Mermaid source text (inline or from file) | +| `show` | Print the current Mermaid source code | + +### Export + +Render and share commands. + +| Command | Description | +|---------|-------------| +| `render` | Render the diagram to SVG or PNG via mermaid.ink | +| `share` | Generate a Mermaid Live Editor URL for sharing | + +### Session + +Session state commands. + +| Command | Description | +|---------|-------------| +| `status` | Show current session state | +| `undo` | Undo the last diagram source change | +| `redo` | Redo the last undone change | + +## Examples + +### Create and Render a Flowchart + +```bash +# Create a project with flowchart sample +cli-anything-mermaid project new --sample flowchart -o flow.json + +# Replace diagram source +cli-anything-mermaid --project flow.json diagram set --text "graph TD; A-->B; B-->C;" + +# Render to SVG +cli-anything-mermaid --project flow.json export render output.svg --format svg +``` + +### Create a Sequence Diagram + +```bash +# Create project with sequence sample +cli-anything-mermaid project new --sample sequence -o seq.json + +# Set diagram from file +cli-anything-mermaid --project seq.json diagram set --file my_diagram.mmd + +# Render to PNG +cli-anything-mermaid --project seq.json export render output.png --format png +``` + +### Share a Diagram + +```bash +# Generate an editable Mermaid Live URL +cli-anything-mermaid --project flow.json export share --mode edit + +# Generate a view-only URL +cli-anything-mermaid --project flow.json export share --mode view +``` + +### Interactive REPL Session + +```bash +cli-anything-mermaid +# new flowchart +# set graph TD; A-->B; B-->C; +# render output.svg +# share +# quit +``` + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Revert or replay diagram source changes +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-mermaid project info + +# JSON output for agents +cli-anything-mermaid --json project info +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after render operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 diff --git a/skills/cli-anything-mubu/SKILL.md b/skills/cli-anything-mubu/SKILL.md new file mode 100644 index 000000000..bbab3086a --- /dev/null +++ b/skills/cli-anything-mubu/SKILL.md @@ -0,0 +1,201 @@ +--- +name: "cli-anything-mubu" +description: >- + Command-line interface for Mubu - Canonical packaged entrypoint for the Mubu live bridge.... +--- + +# cli-anything-mubu + +Canonical packaged entrypoint for the Mubu live bridge. + +## Installation + +This CLI is packaged from the canonical `agent-harness` source tree: + +```bash +pip install -e . +``` + +**Prerequisites:** +- Python 3.10+ +- An active Mubu desktop session on this machine +- Local Mubu profile data available to the CLI +- Set `MUBU_DAILY_FOLDER` if you want no-argument daily helpers + +## Entry Points + +```bash +cli-anything-mubu +python -m cli_anything.mubu +``` + +When invoked without a subcommand, the CLI enters an interactive REPL session. + +## Command Groups + + +### Discover + +Discovery commands for folders, documents, recency, and daily-document resolution. + +| Command | Description | +|---------|-------------| + +| `docs` | List latest known document snapshots from local backups. | + +| `folders` | List folder metadata from local RxDB storage. | + +| `folder-docs` | List document metadata for one folder. | + +| `path-docs` | List documents for one folder path or folder id. | + +| `recent` | List recently active documents using backups, metadata, and sync logs. | + +| `daily` | Find Daily-style folders and list the documents inside them. | + +| `daily-current` | Resolve the current daily document from one Daily-style folder. | + + + +### Inspect + +Inspection commands for tree views, search, links, sync events, and live node targeting. + +| Command | Description | +|---------|-------------| + +| `show` | Show the latest backup tree for one document. | + +| `search` | Search latest backups for matching node text or note content. | + +| `changes` | Parse recent client-sync change events from local logs. | + +| `links` | Extract outbound Mubu document links from one document backup. | + +| `open-path` | Open one document by full path, suffix path, title, or doc id. | + +| `doc-nodes` | List live document nodes with node ids and update-target paths. | + +| `daily-nodes` | List live nodes from the current daily document in one step. | + + + +### Mutate + +Mutation commands for dry-run-first atomic live edits against the Mubu API. + +| Command | Description | +|---------|-------------| + +| `create-child` | Build or execute one child-node creation against the live Mubu API. | + +| `delete-node` | Build or execute one node deletion against the live Mubu API. | + +| `update-text` | Build or execute one text update against the live Mubu API. | + + + +### Session + +Session and state commands for current document/node context and local command history. + +| Command | Description | +|---------|-------------| + +| `status` | Show the current session state. | + +| `state-path` | Show the session state file path. | + +| `use-doc` | Persist the current document reference. | + +| `use-node` | Persist the current node reference. | + +| `use-daily` | Resolve and persist the current daily document reference. | + +| `clear-doc` | Clear the current document reference. | + +| `clear-node` | Clear the current node reference. | + +| `history` | Show recent command history stored in session state. | + + + +## Recommended Agent Workflow + +```text +discover daily-current '' --json + -> +inspect daily-nodes '' --query '' --json + -> +session use-doc '' + -> +mutate update-text / create-child / delete-node --json + -> +--execute only after payload inspection +``` + +## Safety Rules + +1. Prefer grouped commands for agent use; flat legacy commands remain for compatibility. +2. Use `--json` whenever an agent will parse the output. +3. Prefer `discover` or `inspect` commands before any `mutate` command. +4. Live mutations are dry-run by default and only execute with `--execute`. +5. Prefer `--node-id` and `--parent-node-id` over text matching. +6. `delete-node` removes the full targeted subtree. +7. Even same-text updates can still advance document version history. +8. Pass a daily-folder reference explicitly or set `MUBU_DAILY_FOLDER` before using no-arg daily helpers. + +## Examples + + +### Interactive REPL Session + +Start an interactive session with persistent document and node context. + +```bash +cli-anything-mubu +# Enter commands interactively +# Use 'help' to see builtins +# Use session commands to persist current-doc/current-node +``` + + +### Discover Current Daily Note + +Resolve the current daily note from an explicit folder reference. + +```bash +cli-anything-mubu --json discover daily-current '' +``` + + +### Dry-Run Atomic Update + +Inspect the exact outgoing payload before a live mutation. + +```bash +cli-anything-mubu mutate update-text '' --node-id --text 'new text' --json +``` + + +## Session State + +The CLI maintains lightweight session state in JSON: + +- `current_doc` +- `current_node` +- local command history + +Use the `session` command group to inspect or update this state. + +## For AI Agents + +1. Start with `discover` or `inspect`, not `mutate`. +2. Use `session status --json` to recover persisted context. +3. Use grouped commands in generated prompts and automation. +4. Verify postconditions after any live mutation. +5. Read the package `TEST.md` and `README.md` when stricter operational detail is needed. + +## Version + +0.1.1 \ No newline at end of file diff --git a/skills/cli-anything-musescore/SKILL.md b/skills/cli-anything-musescore/SKILL.md new file mode 100644 index 000000000..0090bd5c7 --- /dev/null +++ b/skills/cli-anything-musescore/SKILL.md @@ -0,0 +1,94 @@ +--- +name: "cli-anything-musescore" +display_name: MuseScore +version: 1.0.0 +description: CLI for music notation — transpose, export PDF/audio/MIDI, extract parts, manage instruments +requires: MuseScore 4 (musescore.org) +entry_point: cli-anything-musescore +category: music +--- + +# MuseScore CLI Skill + +## Overview + +Wraps MuseScore 4's `mscore` backend for music notation tasks: transposition, export to multiple formats (PDF, PNG, MP3, MIDI, MusicXML, Braille), part extraction, instrument management, and score analysis. + +## Commands + +### Project Management +```bash +cli-anything-musescore --json project info -i score.mscz +cli-anything-musescore --json project open -i score.mscz +``` + +### Transposition +```bash +# Transpose to a target key +cli-anything-musescore --json transpose by-key -i score.mscz -o out.mscz --target-key "C major" --direction closest + +# Transpose by semitones +cli-anything-musescore --json transpose by-interval -i score.mscz -o out.mscz --semitones 3 + +# Diatonic transposition +cli-anything-musescore --json transpose diatonic -i score.mscz -o out.mscz --steps 2 +``` + +### Part Extraction +```bash +cli-anything-musescore --json parts list -i score.mscz +cli-anything-musescore --json parts extract -i score.mscz -o piano.mscz --part "Piano" +cli-anything-musescore --json parts generate -i score.mscz -d ./parts/ +``` + +### Export +```bash +cli-anything-musescore --json export pdf -i score.mscz -o score.pdf +cli-anything-musescore --json export mp3 -i score.mscz -o score.mp3 --bitrate 192 +cli-anything-musescore --json export png -i score.mscz -o score.png --dpi 300 +cli-anything-musescore --json export midi -i score.mscz -o score.mid +cli-anything-musescore --json export musicxml -i score.mscz -o score.musicxml +cli-anything-musescore --json export braille -i score.mscz -o score.brf +cli-anything-musescore --json export batch -i score.mscz -o score.pdf -o score.mid +``` + +### Instrument Management +```bash +cli-anything-musescore --json instruments list -i score.mscz +cli-anything-musescore --json instruments add -i score.mscz -o out.mscz --id keyboard.piano --name "Piano" +cli-anything-musescore --json instruments remove -i score.mscz -o out.mscz --name "Violin" +``` + +### Score Analysis +```bash +cli-anything-musescore --json media probe -i score.mscz +cli-anything-musescore --json media stats -i score.mscz +cli-anything-musescore --json media diff --reference a.mscz --compare b.mscz +``` + +### Session +```bash +cli-anything-musescore --json session status +cli-anything-musescore --json session undo +cli-anything-musescore --json session redo +cli-anything-musescore --json session history +``` + +## Supported Input Formats +- `.mscz` (MuseScore native) +- `.mxl` (compressed MusicXML) +- `.musicxml` / `.xml` (MusicXML) +- `.mid` / `.midi` (MIDI) + +## Key Names for Transposition +Major: Cb, Gb, Db, Ab, Eb, Bb, F, C, G, D, A, E, B, F#, C# +Minor: Ab, Eb, Bb, F, C, G, D, A, E, B, F#, C#, G#, D#, A# + +Accepted formats: "C", "C major", "Am", "A minor", "Db major", "F# minor" + +## Agent Guidance +- Always use `--json` flag for machine-readable output +- Verify exports with `export verify` after rendering +- Use `media probe` to inspect an unknown score before operating on it +- Transposition requires both `-i` (input) and `-o` (output) +- Part names are case-insensitive for `parts extract` diff --git a/skills/cli-anything-n8n/SKILL.md b/skills/cli-anything-n8n/SKILL.md new file mode 100644 index 000000000..e74dac4b9 --- /dev/null +++ b/skills/cli-anything-n8n/SKILL.md @@ -0,0 +1,50 @@ +--- +name: "cli-anything-n8n" +description: >- + Command-line interface for n8n workflow automation platform. + Manages workflows, executions, credentials, variables, and tags. + Based on n8n Public API v1.1.1 (n8n >= 1.0.0). +--- + +# cli-anything-n8n + +CLI harness for n8n workflow automation — built with the CLI-Anything pattern. +Verified against n8n OpenAPI spec v1.1.1. + +## Installation + +```bash +pip install cli-anything-n8n +``` + +## Configuration + +```bash +cli-anything-n8n config set base_url https://your-n8n-instance.com +cli-anything-n8n config set api_key your-api-key + +# Or environment variables +export N8N_BASE_URL=https://your-n8n-instance.com +export N8N_API_KEY=your-api-key +export N8N_TIMEOUT=60 # optional, default 30s +``` + +## Command Groups + +| Group | Commands | +|-------|----------| +| workflow | list, get, create, update, delete, activate, deactivate, tags, set-tags, transfer | +| execution | list, get, delete, retry | +| credential | create, delete, schema, transfer | +| variable | list, create, update, delete | +| tag | list, get, create, update, delete | +| config | show, set | + +## For AI Agents + +- Always use `--json` flag for structured output +- Use `@file.json` to pass complex JSON from files +- Check return codes: 0 = success, non-zero = error +- All IDs are strings, not integers +- API key is always masked in `config show` output +- Not available in public API: data tables, credential listing, execution stop diff --git a/skills/cli-anything-notebooklm/SKILL.md b/skills/cli-anything-notebooklm/SKILL.md new file mode 100644 index 000000000..bfde892df --- /dev/null +++ b/skills/cli-anything-notebooklm/SKILL.md @@ -0,0 +1,78 @@ +--- +name: "cli-anything-notebooklm" +description: Experimental NotebookLM harness for listing notebooks, managing sources, asking questions, generating artifacts, and downloading outputs through an installed notebooklm CLI. +--- + +# cli-anything-notebooklm + +Experimental NotebookLM harness for CLI-Anything. + +## Installation + +This package is intended to be installed from the harness directory: + +```bash +cd notebooklm/agent-harness +python3 -m pip install -e . +``` + +Install the upstream NotebookLM CLI if needed: + +```bash +python3 -m pip install --user 'notebooklm-py[browser]' +python3 -m playwright install chromium +``` + +## Requirements + +- `notebooklm` command installed locally +- Valid local NotebookLM login session + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-notebooklm --help + +# Start with a notebook context +cli-anything-notebooklm --notebook nb_123 source list + +# Prefer JSON for agent use +cli-anything-notebooklm --json notebook list +``` + +## Command Groups + +| Group | Purpose | +| --- | --- | +| `auth` | login and auth validation | +| `notebook` | notebook list, create, summary | +| `source` | source listing and URL add | +| `chat` | ask questions and inspect history | +| `artifact` | list and generate artifacts | +| `download` | fetch generated outputs | +| `share` | inspect sharing state | + +## Agent Workflow + +1. Check auth with `cli-anything-notebooklm auth status` +2. Discover notebook IDs with `cli-anything-notebooklm --json notebook list` +3. Use explicit `--notebook` for follow-up commands +4. Prefer `--json` only where the upstream `notebooklm` command supports it + +## Agent Guidance + +- Prefer explicit notebook IDs with `--notebook`. +- Use `--json` for machine-readable output only on commands that support it upstream. +- Treat this harness as experimental and unofficial. +- Do not expose auth files or cookies in logs. +- NotebookLM is a Google product; this harness is unofficial and not affiliated with Google. + +## References + +- CLI-Anything: https://github.com/HKUDS/CLI-Anything +- CLI-Anything HARNESS.md: https://github.com/HKUDS/CLI-Anything/blob/main/cli-anything-plugin/HARNESS.md +- notebooklm-py: https://github.com/teng-lin/notebooklm-py +- Google NotebookLM help: https://support.google.com/notebooklm/answer/16206563 diff --git a/skills/cli-anything-novita/SKILL.md b/skills/cli-anything-novita/SKILL.md new file mode 100644 index 000000000..2634857e6 --- /dev/null +++ b/skills/cli-anything-novita/SKILL.md @@ -0,0 +1,170 @@ +--- +name: "cli-anything-novita" +description: >- + Command-line interface for Novita AI - An OpenAI-compatible AI API client for DeepSeek, GLM, and other models. +--- + +# cli-anything-novita + +A CLI harness for **Novita AI** - an OpenAI-compatible API service for AI models like DeepSeek, GLM, and others. + +## Installation + +This CLI is installed as part of the cli-anything-novita package: + +```bash +pip install cli-anything-novita +``` + +**Prerequisites:** +- Python 3.10+ +- Novita API key from [novita.ai](https://novita.ai) + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-novita --help + +# Start interactive REPL mode +cli-anything-novita + +# Chat with model +cli-anything-novita chat --prompt "What is AI?" --model deepseek/deepseek-v3.2 + +# Streaming chat +cli-anything-novita stream --prompt "Write a poem about code" + +# List available models +cli-anything-novita models + +# JSON output (for agent consumption) +cli-anything-novita --json chat --prompt "Hello" +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-novita +# Enter commands interactively with tab-completion and history +``` + +## Command Groups + +### Chat + +Chat with AI models through the Novita API. + +| Command | Description | +|---------|-------------| +| `chat` | Chat with the Novita API | +| `stream` | Stream chat completion | + +### Session + +Session management for chat history. + +| Command | Description | +|---------|-------------| +| `status` | Show session status | +| `clear` | Clear session history | +| `history` | Show command history | + +### Config + +Configuration management. + +| Command | Description | +|---------|-------------| +| `set` | Set a configuration value | +| `get` | Get a configuration value (or show all) | +| `delete` | Delete a configuration value | +| `path` | Show the config file path | + +### Utility + +| Command | Description | +|---------|-------------| +| `test` | Test API connectivity | +| `models` | List available models | + +## Examples + +### Configure API Key + +```bash +# Set API key via config file (recommended) +cli-anything-novita config set api_key "sk-xxx" + +# Or use environment variable +export NOVITA_API_KEY="sk-xxx" +``` + +### Chat with DeepSeek + +```bash +# Simple chat +cli-anything-novita chat --prompt "Explain quantum computing" --model deepseek/deepseek-v3.2 + +# Streaming chat +cli-anything-novita stream --prompt "Write a Python function to calculate factorial" +``` + +### Test Connectivity + +```bash +# Verify API key and connectivity +cli-anything-novita test --model deepseek/deepseek-v3.2 + +# List all available models +cli-anything-novita models +``` + +## Default Models + +The Novita API supports multiple model providers: + +| Model ID | Provider | Description | +|----------|----------|-------------| +| `deepseek/deepseek-v3.2` | DeepSeek | DeepSeek V3.2 model (default) | +| `zai-org/glm-5` | Zhipu AI | GLM-5 model | +| `minimax/minimax-m2.5` | MiniMax | MiniMax M2.5 model | + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-novita chat --prompt "Hello" + +# JSON output for agents +cli-anything-novita --json chat --prompt "Hello" +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 diff --git a/skills/cli-anything-obs-studio/SKILL.md b/skills/cli-anything-obs-studio/SKILL.md new file mode 100644 index 000000000..4c9b6626d --- /dev/null +++ b/skills/cli-anything-obs-studio/SKILL.md @@ -0,0 +1,230 @@ +--- +name: "cli-anything-obs-studio" +description: >- + Command-line interface for Obs Studio - A stateful command-line interface for OBS Studio scene collection editing, following the same patter... +--- + +# cli-anything-obs_studio + +A stateful command-line interface for OBS Studio scene collection editing, following the same patterns as the Blender CLI harness. Uses a JSON scene collection format. No OBS installation required for editing. + +## Installation + +This CLI is installed as part of the cli-anything-obs_studio package: + +```bash +pip install cli-anything-obs_studio +``` + +**Prerequisites:** +- Python 3.10+ +- obs_studio must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-obs_studio --help + +# Start interactive REPL mode +cli-anything-obs_studio + +# Create a new project +cli-anything-obs_studio project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-obs_studio --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-obs_studio +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management commands. + +| Command | Description | +|---------|-------------| +| `new` | Create a new OBS scene collection | +| `open` | Open an existing project | +| `save` | Save the current project | +| `info` | Show project information | +| `json` | Print raw project JSON | + + +### Scene Group + +Scene management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a new scene | +| `remove` | Remove a scene by index | +| `duplicate` | Duplicate a scene | +| `set-active` | Set the active scene | +| `list` | List all scenes | + + +### Source Group + +Source management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a source to a scene | +| `remove` | Remove a source by index | +| `duplicate` | Duplicate a source | +| `set` | Set a source property (name, visible, locked, opacity, rotation) | +| `transform` | Transform a source (position, size, crop, rotation) | +| `list` | List all sources in a scene | + + +### Filter Group + +Filter management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a filter to a source | +| `remove` | Remove a filter from a source | +| `set` | Set a filter parameter | +| `list` | List all filters on a source | +| `list-available` | List all available filter types | + + +### Audio Group + +Audio management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a global audio source | +| `remove` | Remove a global audio source | +| `volume` | Set volume for an audio source (0.0-3.0) | +| `mute` | Mute an audio source | +| `unmute` | Unmute an audio source | +| `monitor` | Set audio monitoring type | +| `list` | List all audio sources | + + +### Transition Group + +Transition management commands. + +| Command | Description | +|---------|-------------| +| `add` | Add a transition | +| `remove` | Remove a transition | +| `set-active` | Set the active transition | +| `duration` | Set transition duration in milliseconds | +| `list` | List all transitions | + + +### Output Group + +Output/streaming/recording configuration. + +| Command | Description | +|---------|-------------| +| `streaming` | Configure streaming settings | +| `recording` | Configure recording settings | +| `settings` | Configure output settings | +| `info` | Show current output configuration | +| `presets` | List available encoding presets | + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| +| `status` | Show session status | +| `undo` | Undo the last operation | +| `redo` | Redo the last undone operation | +| `history` | Show undo history | + + + + +## Examples + + +### Create a New Project + +Create a new obs_studio project file. + +```bash +cli-anything-obs_studio project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-obs_studio --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-obs_studio +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-obs_studio project info -p project.json + +# JSON output for agents +cli-anything-obs_studio --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/skills/cli-anything-obsidian/SKILL.md b/skills/cli-anything-obsidian/SKILL.md new file mode 100644 index 000000000..f0e4c77c7 --- /dev/null +++ b/skills/cli-anything-obsidian/SKILL.md @@ -0,0 +1,234 @@ +--- +name: "cli-anything-obsidian" +description: >- + Command-line interface for Obsidian — Knowledge management and note-taking via Obsidian Local REST API. Designed for AI agents and power users who need to manage notes, search the vault, and execute commands without the GUI. +--- + +# cli-anything-obsidian + +Knowledge management and note-taking via the Obsidian Local REST API. Designed for AI agents and power users who need to manage notes, search the vault, and execute commands without the GUI. + +## Installation + +This CLI is installed as part of the cli-anything-obsidian package: + +```bash +pip install cli-anything-obsidian +``` + +**Prerequisites:** +- Python 3.10+ +- Obsidian must be installed and running with the [Local REST API plugin](https://github.com/coddingtonbear/obsidian-local-rest-api) enabled + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-obsidian --help + +# Start interactive REPL mode +cli-anything-obsidian + +# List vault files +cli-anything-obsidian vault list + +# Run with JSON output (for agent consumption) +cli-anything-obsidian --json vault list +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-obsidian +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Vault + +Vault file management commands. + +| Command | Description | +|---------|-------------| +| `list` | List files in the vault or a subdirectory | +| `read` | Read the content of a note | +| `create` | Create a new note | +| `update` | Overwrite an existing note | +| `delete` | Delete a note from the vault | +| `append` | Append content to an existing note | + + +### Search + +Vault search commands. + +| Command | Description | +|---------|-------------| +| `query` | Search using Obsidian query syntax | +| `simple` | Plain text search across the vault | + + +### Note + +Active note commands. + +| Command | Description | +|---------|-------------| +| `active` | Get the currently active note in Obsidian | +| `open` | Open a note in the Obsidian editor | + + +### Command + +Obsidian command palette commands. + +| Command | Description | +|---------|-------------| +| `list` | List all available Obsidian commands | +| `execute` | Execute a command by its ID | + + +### Server + +Server status and info commands. + +| Command | Description | +|---------|-------------| +| `status` | Check if the Obsidian Local REST API is running | + + +### Session + +Session state commands. + +| Command | Description | +|---------|-------------| +| `status` | Show current session state | + + + +## Examples + + +### List and Read Notes + +```bash +# List all vault files +cli-anything-obsidian vault list + +# List files in a subdirectory +cli-anything-obsidian vault list "Daily Notes" + +# Read a note +cli-anything-obsidian vault read "Projects/my-project.md" +``` + + +### Create and Update Notes + +```bash +# Create a new note +cli-anything-obsidian vault create "Projects/new-project.md" --content "# New Project" + +# Update (overwrite) a note +cli-anything-obsidian vault update "Projects/new-project.md" --content "# Updated Content" + +# Append to a note +cli-anything-obsidian vault append "Projects/new-project.md" --content "\n## New Section" +``` + + +### Search + +```bash +# Plain text search +cli-anything-obsidian search simple "meeting notes" + +# Obsidian query syntax search (tags, links, etc.) +cli-anything-obsidian search query "tag:#project" +``` + + +### Commands + +```bash +# List available commands +cli-anything-obsidian command list + +# Execute a command by ID +cli-anything-obsidian command execute "editor:toggle-bold" +``` + + +### Interactive REPL Session + +Start an interactive session for exploratory use. + +```bash +cli-anything-obsidian +# Enter commands interactively +# Use 'help' to see available commands +``` + + +### API Key Configuration + +```bash +# Via flag +cli-anything-obsidian --api-key YOUR_KEY vault list + +# Via environment variable (recommended for agents) +export OBSIDIAN_API_KEY=YOUR_KEY +cli-anything-obsidian vault list +``` + + +## State Management + +The CLI maintains lightweight session state: + +- **API key**: Configurable via `--api-key` or `OBSIDIAN_API_KEY` environment variable +- **Host URL**: Defaults to `https://localhost:27124`; configurable via `--host` + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-obsidian vault list + +# JSON output for agents +cli-anything-obsidian --json vault list +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Set `OBSIDIAN_API_KEY`** environment variable to avoid passing `--api-key` on every call +5. **Verify Obsidian is running** with `server status` before other commands + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 diff --git a/skills/cli-anything-ollama/SKILL.md b/skills/cli-anything-ollama/SKILL.md new file mode 100644 index 000000000..87b860d71 --- /dev/null +++ b/skills/cli-anything-ollama/SKILL.md @@ -0,0 +1,220 @@ +--- +name: "cli-anything-ollama" +description: >- + Command-line interface for Ollama - Local LLM inference and model management via Ollama REST API. Designed for AI agents and power users who need to manage models, generate text, chat, and create embeddings without a GUI. +--- + +# cli-anything-ollama + +Local LLM inference and model management via the Ollama REST API. Designed for AI agents and power users who need to manage models, generate text, chat, and create embeddings without a GUI. + +## Installation + +This CLI is installed as part of the cli-anything-ollama package: + +```bash +pip install cli-anything-ollama +``` + +**Prerequisites:** +- Python 3.10+ +- Ollama must be installed and running (`ollama serve`) + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-ollama --help + +# Start interactive REPL mode +cli-anything-ollama + +# List available models +cli-anything-ollama model list + +# Run with JSON output (for agent consumption) +cli-anything-ollama --json model list +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-ollama +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Model + +Model management commands. + +| Command | Description | +|---------|-------------| +| `list` | List locally available models | +| `show` | Show model details (parameters, template, license) | +| `pull` | Download a model from the Ollama library | +| `rm` | Delete a model from local storage | +| `copy` | Copy a model to a new name | +| `ps` | List models currently loaded in memory | + + +### Generate + +Text generation and chat commands. + +| Command | Description | +|---------|-------------| +| `text` | Generate text from a prompt | +| `chat` | Send a chat completion request | + + +### Embed + +Embedding generation commands. + +| Command | Description | +|---------|-------------| +| `text` | Generate embeddings for text | + + +### Server + +Server status and info commands. + +| Command | Description | +|---------|-------------| +| `status` | Check if Ollama server is running | +| `version` | Show Ollama server version | + + +### Session + +Session state commands. + +| Command | Description | +|---------|-------------| +| `status` | Show current session state | +| `history` | Show chat history for current session | + + + +## Examples + + +### List and Pull Models + +```bash +# List available models +cli-anything-ollama model list + +# Pull a model +cli-anything-ollama model pull llama3.2 + +# Show model details +cli-anything-ollama model show llama3.2 +``` + + +### Generate Text + +```bash +# Stream text (default) +cli-anything-ollama generate text --model llama3.2 --prompt "Explain quantum computing in one sentence" + +# Non-streaming with JSON output (for agents) +cli-anything-ollama --json generate text --model llama3.2 --prompt "Hello" --no-stream +``` + + +### Chat + +```bash +# Single-turn chat +cli-anything-ollama generate chat --model llama3.2 --message "user:What is Python?" + +# Multi-turn chat +cli-anything-ollama generate chat --model llama3.2 \ + --message "user:What is Python?" \ + --message "user:How does it compare to JavaScript?" + +# Chat from JSON file +cli-anything-ollama generate chat --model llama3.2 --file messages.json +``` + + +### Embeddings + +```bash +cli-anything-ollama embed text --model nomic-embed-text --input "Hello world" +cli-anything-ollama embed text --model nomic-embed-text --input "Hello" --input "World" +``` + + +### Interactive REPL Session + +Start an interactive session for exploratory use. + +```bash +cli-anything-ollama +# Enter commands interactively +# Use 'help' to see available commands +``` + + +### Connect to Remote Host + +```bash +cli-anything-ollama --host http://192.168.1.100:11434 model list +``` + + +## State Management + +The CLI maintains lightweight session state: + +- **Current host URL**: Configurable via `--host` +- **Chat history**: Tracked for multi-turn conversations in REPL +- **Last used model**: Shown in REPL prompt + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-ollama model list + +# JSON output for agents +cli-anything-ollama --json model list +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use `--no-stream`** for generate/chat to get complete responses +5. **Verify Ollama is running** with `server status` before other commands + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.1 diff --git a/skills/cli-anything-openclaw/SKILL.md b/skills/cli-anything-openclaw/SKILL.md new file mode 100644 index 000000000..57da8b9b6 --- /dev/null +++ b/skills/cli-anything-openclaw/SKILL.md @@ -0,0 +1,220 @@ +--- +name: "cli-anything-openclaw" +description: > + Use when the agent wants to define, list, inspect, or execute GUI macros + via the OpenClaw Macro System CLI. Macros are parameterized, CLI-callable + workflows — the agent invokes `macro run ` and the system handles + backend routing (plugin, file transform, accessibility, compiled GUI replay). +--- + +# OpenClaw Macro System CLI + +## What It Is + +The OpenClaw Macro System converts valuable GUI workflows into parameterized, +CLI-callable macros. Agents **never touch the GUI directly** — they call macros +through this stable CLI, and the runtime routes execution to the best available +backend (native plugin/API, file transformation, semantic UI control, or +precompiled GUI macro replay). + +## Installation + +```bash +cd openclaw-skill/agent-harness +pip install -e . +``` + +**Requirements:** Python 3.10+, PyYAML, click, prompt-toolkit. + +## Quick Start (for agents) + +```bash +# 1. See what macros are available +cli-anything-openclaw macro list --json + +# 2. Inspect a macro's parameters +cli-anything-openclaw macro info export_file --json + +# 3. Dry-run to check params without side effects +cli-anything-openclaw --dry-run macro run export_file \ + --param output=/tmp/test.txt --json + +# 4. Execute a macro +cli-anything-openclaw macro run export_file \ + --param output=/tmp/result.txt --json + +# 5. See what backends are available +cli-anything-openclaw backends --json +``` + +## Command Reference + +### Global Flags + +| Flag | Description | +|------|-------------| +| `--json` | Machine-readable JSON output on stdout | +| `--dry-run` | Simulate all steps, skip side effects | +| `--session-id ` | Resume or create a named session | + +### `macro` group + +| Command | Description | +|---------|-------------| +| `macro list` | List all available macros | +| `macro info ` | Show macro schema (parameters, steps, conditions) | +| `macro run --param k=v` | Execute a macro | +| `macro dry-run --param k=v` | Simulate without side effects | +| `macro validate [name]` | Structural validation | +| `macro define ` | Scaffold a new macro YAML | + +### `session` group + +| Command | Description | +|---------|-------------| +| `session status` | Show session statistics | +| `session history` | Show recent run history | +| `session save` | Persist session to disk | +| `session list` | List all saved sessions | + +### `backends` + +```bash +cli-anything-openclaw backends --json +# Shows: native_api, file_transform, semantic_ui, gui_macro, recovery +# and whether each is available in the current environment. +``` + +## Macro Parameters + +Pass parameters with `--param key=value`. Repeat for multiple: + +```bash +cli-anything-openclaw macro run transform_json \ + --param file=/path/to/data.json \ + --param key=settings.theme \ + --param value=dark \ + --json +``` + +## Output Format (--json) + +All commands output JSON when `--json` is set: + +```json +{ + "success": true, + "macro_name": "export_file", + "output": { + "exported_file": "/tmp/result.txt" + }, + "error": "", + "telemetry": { + "duration_ms": 312, + "steps_total": 2, + "steps_run": 2, + "backends_used": ["native_api"], + "dry_run": false + } +} +``` + +On failure (`"success": false`), read the `"error"` field for the reason. +Exit code is 1 on failure. + +## Execution Backends + +Backends are selected automatically based on the macro step definition: + +| Backend | Triggered by | Use case | +|---------|-------------|----------| +| `native_api` | `backend: native_api` | Subprocess / shell command | +| `file_transform` | `backend: file_transform` | XML, JSON, text file editing | +| `semantic_ui` | `backend: semantic_ui` | Accessibility / keyboard shortcuts | +| `gui_macro` | `backend: gui_macro` | Precompiled coordinate replay | +| `recovery` | `backend: recovery` | Retry / fallback orchestration | + +## Writing Macros + +Macros are YAML files in `cli_anything/openclaw/macro_definitions/`. +Scaffold one with: + +```bash +cli-anything-openclaw macro define my_macro --output \ + cli_anything/openclaw/macro_definitions/examples/my_macro.yaml +``` + +Minimal schema: + +```yaml +name: my_macro +version: "1.0" +description: What this macro does. + +parameters: + output: + type: string + required: true + description: Where to write results. + example: /tmp/result.txt + +preconditions: + - file_exists: /path/to/input + +steps: + - id: step1 + backend: native_api + action: run_command + params: + command: [my-app, --export, "${output}"] + timeout_ms: 30000 + on_failure: fail # or: skip, continue + +postconditions: + - file_exists: ${output} + - file_size_gt: [${output}, 100] + +outputs: + - name: result_file + path: ${output} + +agent_hints: + danger_level: safe # safe | moderate | dangerous + side_effects: [creates_file] + reversible: true +``` + +## Agent Usage Rules + +1. **Always use `--json`** for programmatic output. +2. **Use `--dry-run` to validate params** before executing side-effectful macros. +3. **Check `success` field** — do not assume success from exit code alone. +4. **Read `error` field** when `success` is false — it explains what failed. +5. **Use `macro info ` to discover params** before calling `macro run`. +6. **Use absolute paths** for all file parameters. + +## Example Workflow + +```bash +# Step 1: What's available? +cli-anything-openclaw macro list --json + +# Step 2: What params does transform_json need? +cli-anything-openclaw macro info transform_json --json + +# Step 3: Test safely +cli-anything-openclaw --dry-run macro run transform_json \ + --param file=/tmp/config.json \ + --param key=theme \ + --param value=dark --json + +# Step 4: Execute for real +cli-anything-openclaw macro run transform_json \ + --param file=/tmp/config.json \ + --param key=theme \ + --param value=dark --json +``` + +## Version + +1.0.0 diff --git a/skills/cli-anything-openscreen/SKILL.md b/skills/cli-anything-openscreen/SKILL.md new file mode 100644 index 000000000..7797f642c --- /dev/null +++ b/skills/cli-anything-openscreen/SKILL.md @@ -0,0 +1,178 @@ +--- +name: "cli-anything-openscreen" +description: >- + Command-line interface for Openscreen — a screen recording editor. + A stateful CLI for editing screen recordings with zoom, speed ramps, + trim, crop, annotations, and polished exports. Built on the Openscreen + JSON project format with ffmpeg as the rendering backend. Designed for + AI agents and power users who need programmatic video editing. +--- + +# cli-anything-openscreen + +A stateful command-line interface for editing screen recordings. Transform raw +captures into polished demo videos with zoom effects, speed adjustments, +trimming, annotations, and beautiful backgrounds. + +## Installation + +```bash +pip install cli-anything-openscreen +``` + +**Prerequisites:** +- Python 3.10+ +- ffmpeg must be installed on your system + +## Usage + +### Basic Commands + +```bash +cli-anything-openscreen --help +cli-anything-openscreen # REPL mode +cli-anything-openscreen project new -v recording.mp4 -o project.openscreen +cli-anything-openscreen --json project info +``` + +### REPL Mode + +Run `cli-anything-openscreen` without arguments to enter interactive mode. +Type `help` for available commands, `quit` to exit. + +## Command Groups + +### project + +Create, open, save, and configure projects. + +| Command | Description | +|---------|-------------| +| `project new [-v VIDEO] [-o PATH]` | Create new project with optional video | +| `project open ` | Open existing .openscreen project | +| `project save [-o PATH]` | Save project to file | +| `project info` | Show project metadata and region counts | +| `project set-video ` | Set source video file | +| `project set ` | Set editor setting (padding, wallpaper, etc.) | + +### zoom + +Manage zoom regions — smooth zoom effects on specific timeline areas. + +| Command | Description | +|---------|-------------| +| `zoom list` | List all zoom regions | +| `zoom add --start MS --end MS [--depth 1-6] [--focus-x 0-1] [--focus-y 0-1]` | Add zoom | +| `zoom remove ` | Remove zoom region | + +Zoom depths: 1=1.25x, 2=1.5x, 3=1.8x, 4=2.2x, 5=3.5x, 6=5.0x + +### speed + +Manage speed regions — speed up idle time, slow down important moments. + +| Command | Description | +|---------|-------------| +| `speed list` | List all speed regions | +| `speed add --start MS --end MS [--speed 0.25-2.0]` | Add speed change | +| `speed remove ` | Remove speed region | + +Valid speeds: 0.25, 0.5, 0.75, 1.25, 1.5, 1.75, 2.0 + +### trim + +Manage trim regions — cut out sections of the recording. + +| Command | Description | +|---------|-------------| +| `trim list` | List all trim regions | +| `trim add --start MS --end MS` | Cut out a section | +| `trim remove ` | Remove trim region | + +### crop + +Set the visible area of the recording. + +| Command | Description | +|---------|-------------| +| `crop get` | Show current crop region | +| `crop set --x 0-1 --y 0-1 --width 0-1 --height 0-1` | Set crop (normalized) | + +### annotation + +Add text overlays to the recording. + +| Command | Description | +|---------|-------------| +| `annotation list` | List all annotations | +| `annotation add-text --start MS --end MS --text "..." [--x 0-1] [--y 0-1]` | Add text | +| `annotation remove ` | Remove annotation | + +### media + +Inspect and validate media files. + +| Command | Description | +|---------|-------------| +| `media probe ` | Show video metadata (resolution, duration, codec) | +| `media check ` | Validate a video file | +| `media thumbnail [-t TIME]` | Extract a frame | + +### export + +Render the final polished video. + +| Command | Description | +|---------|-------------| +| `export presets` | List available export presets | +| `export render ` | Render project to video file | + +### session + +Manage session state with undo/redo. + +| Command | Description | +|---------|-------------| +| `session status` | Show session info | +| `session undo` | Undo last operation | +| `session redo` | Redo last undone operation | +| `session save` | Save session state to disk | +| `session list` | List all saved sessions | + +## State Management + +- **Undo/Redo**: Up to 50 levels of undo history +- **Project persistence**: JSON `.openscreen` files +- **Session tracking**: auto-tracks modifications + +## Output Formats + +- Human-readable (default): Formatted key-value pairs +- Machine-readable (`--json`): Structured JSON output + +## Editor Settings + +| Setting | Type | Default | Description | +|---------|------|---------|-------------| +| `aspectRatio` | string | "16:9" | 16:9, 9:16, 1:1, 4:3, 4:5 | +| `wallpaper` | string | "gradient_dark" | Background preset | +| `padding` | int | 50 | 0-100, padding around video | +| `borderRadius` | int | 12 | Corner radius in pixels | +| `shadowIntensity` | float | 0 | 0-1, drop shadow strength | +| `motionBlurAmount` | float | 0 | 0-1, motion blur during zoom | +| `exportQuality` | string | "good" | medium, good, source | +| `exportFormat` | string | "mp4" | mp4, gif | + +## For AI Agents + +1. Always use `--json` for parseable output +2. Check return codes — 0 = success, non-zero = error +3. Parse stderr for error messages in non-JSON mode +4. Use absolute file paths +5. After `export render`, verify the output exists and probe it +6. Times are in **milliseconds** for all region commands +7. Coordinates (focus, crop, position) are **normalized 0-1** + +## Version + +1.0.0 diff --git a/skills/cli-anything-pm2/SKILL.md b/skills/cli-anything-pm2/SKILL.md new file mode 100644 index 000000000..4143c650f --- /dev/null +++ b/skills/cli-anything-pm2/SKILL.md @@ -0,0 +1,110 @@ +--- +name: "cli-anything-pm2" +description: >- + Command-line interface for PM2 - A stateless CLI for Node.js process management via the PM2 CLI. List, start, stop, restart processes, view logs, and manage system configuration. +--- + +# cli-anything-pm2 + +A stateless command-line interface for PM2 process management. +Communicates via the PM2 CLI subprocess. No local state or session. + +## Installation + +```bash +pip install -e . +``` + +**Prerequisites:** +- Python 3.10+ +- PM2 installed globally (`npm install -g pm2`) + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-pm2 --help + +# Start interactive REPL mode +cli-anything-pm2 + +# Run with JSON output (for agent consumption) +cli-anything-pm2 --json process list +cli-anything-pm2 --json system version +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-pm2 +# Enter commands interactively with tab-completion and history +``` + +## Command Groups + +### process +Process inspection commands. + +| Command | Description | +|---------|-------------| +| `list` | List all PM2 processes | +| `describe ` | Get detailed info for a process | +| `metrics` | Get metrics for all processes | + +### lifecycle +Process lifecycle commands. + +| Command | Description | +|---------|-------------| +| `start