Skip to content

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

Python

Address reviewer feedback: merge main, fix namespace packages, hardcoded path, PATH mutation, SKILL.md format, setup.py completeness

yuhao369e02b9c013
diff --cc .gitignore
index d4aa7f651,6938b6020..163265cba
--- a/.gitignore
+++ b/.gitignore
@@@ -47,9 -74,14 +74,17 @@@
!/novita/
!/ollama/
!/browser/
+!/seaclip/
+!/pm2/
+!/chromadb/
+ !/musescore/
+ !/krita/
+ !/freecad/
+ !/iterm2/
+ !/slay_the_spire_ii/
+ !/rms/
+ !/renderdoc/
+ !/cloudcompare/
# Step 5: Inside each software dir, ignore everything (including dotfiles)
/gimp/*
@@@ -84,12 -124,26 +127,32 @@@
/ollama/.*
/browser/*
/browser/.*
+/seaclip/*
+/seaclip/.*
+/pm2/*
+/pm2/.*
+/chromadb/*
+/chromadb/.*
+ /musescore/*
+ /musescore/.*
+ /krita/*
+ /krita/.*
+ /freecad/*
+ /freecad/.*
+ /iterm2/*
+ /iterm2/.*
+ /slay_the_spire_ii/*
+ /slay_the_spire_ii/.*
+ /rms/*
+ /rms/.*
+ /renderdoc/*
+ /renderdoc/.*
+ /cloudcompare/*
+ /cloudcompare/.*
+ /wiremock/*
+ /wiremock/.*
+ /exa/*
+ /exa/.*
# Step 6: ...except agent-harness/
!/gimp/agent-harness/
@@@ -109,9 -167,18 +176,21 @@@
!/novita/agent-harness/
!/ollama/agent-harness/
!/browser/agent-harness/
+!/seaclip/agent-harness/
+!/pm2/agent-harness/
+!/chromadb/agent-harness/
+ !/musescore/agent-harness/
+ !/krita/agent-harness/
+ !/freecad/agent-harness/
+ !/iterm2/agent-harness/
+ !/slay_the_spire_ii/agent-harness/
+ !/slay_the_spire_ii/README.md
+ !/rms/agent-harness/
+ !/renderdoc/agent-harness/
+ !/cloudcompare/agent-harness/
+ !/wiremock/
+ !/wiremock/agent-harness/
+ !/exa/agent-harness/
# Step 7: Ignore build artifacts within allowed dirs
**/__pycache__/
diff --cc chromadb/agent-harness/setup.py
index 487458e52,000000000..22f0c1dbe
mode 100644,000000..100644
--- a/chromadb/agent-harness/setup.py
+++ b/chromadb/agent-harness/setup.py
@@@ -1,21 -1,0 +1,45 @@@
- """Setup for cli-anything-chromadb."""
++"""Setup for cli-anything-chromadb — CLI harness for ChromaDB vector database."""
+
- from setuptools import setup, find_packages
++from setuptools import setup, find_namespace_packages
+
+setup(
+ name="cli-anything-chromadb",
+ version="1.0.0",
++ author="cli-anything contributors",
++ author_email="",
+ description="CLI-Anything harness for ChromaDB vector database",
- packages=find_packages(),
++ 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",
- "prompt-toolkit>=3.0",
- "requests>=2.28",
++ "click>=8.0.0",
++ "prompt-toolkit>=3.0.0",
++ "requests>=2.28.0",
+ ],
++ extras_require={
++ "dev": [
++ "pytest>=7.0.0",
++ "pytest-cov>=4.0.0",
++ ],
++ },
+ entry_points={
+ "console_scripts": [
+ "cli-anything-chromadb=cli_anything.chromadb.chromadb_cli:main",
+ ],
+ },
++ package_data={
++ "cli_anything.chromadb": ["skills/*.md"],
++ },
++ include_package_data=True,
++ zip_safe=False,
+)
diff --cc pm2/agent-harness/cli_anything/pm2/skills/SKILL.md
index d34a9d348,000000000..a75f49c18
mode 100644,000000..100644
--- a/pm2/agent-harness/cli_anything/pm2/skills/SKILL.md
+++ b/pm2/agent-harness/cli_anything/pm2/skills/SKILL.md
@@@ -1,40 -1,0 +1,111 @@@
+---
- name: pm2
- version: 1.0.0
- backend: pm2 (subprocess)
- state: stateless
- entry_point: cli-anything-pm2
- groups:
- - process
- - lifecycle
- - logs
- - system
++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.
+---
+
- # PM2 Skills
-
- Skills for the PM2 CLI-Anything harness. Add agent skills here as `.py` files.
-
- ## Available Command Skills
-
- | Skill | Group | Command |
- |-----------------|-----------|--------------------------------------------|
- | List processes | process | `cli-anything-pm2 --json process list` |
- | Describe process| process | `cli-anything-pm2 --json process describe <name>` |
- | Get metrics | process | `cli-anything-pm2 --json process metrics` |
- | Start process | lifecycle | `cli-anything-pm2 lifecycle start <script> --name <name>` |
- | Stop process | lifecycle | `cli-anything-pm2 lifecycle stop <name>` |
- | Restart process | lifecycle | `cli-anything-pm2 lifecycle restart <name>`|
- | Delete process | lifecycle | `cli-anything-pm2 lifecycle delete <name>` |
- | View logs | logs | `cli-anything-pm2 logs view <name> --lines 50` |
- | Flush logs | logs | `cli-anything-pm2 logs flush [name]` |
- | Save process list| system | `cli-anything-pm2 system save` |
- | Startup script | system | `cli-anything-pm2 system startup` |
- | PM2 version | system | `cli-anything-pm2 --json system version` |
-
- ## Planned Skills
-
- - **auto-restart**: Monitor processes and auto-restart on crash
- - **health-check**: Periodic health checks on all PM2 processes
- - **log-rotate**: Automated log rotation and cleanup
- - **deploy**: Rolling restart with zero-downtime deployment
++# 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 <name>` | Get detailed info for a process |
++| `metrics` | Get metrics for all processes |
++
++### lifecycle
++Process lifecycle commands.
++
++| Command | Description |
++|---------|-------------|
++| `start <script> --name <name>` | Start a new process |
++| `stop <name>` | Stop a process |
++| `restart <name>` | Restart a process |
++| `delete <name>` | Delete a process |
++
++### logs
++Log management commands.
++
++| Command | Description |
++|---------|-------------|
++| `view <name> --lines 50` | View recent logs |
++| `flush [name]` | Flush logs |
++
++### system
++System-level commands.
++
++| Command | Description |
++|---------|-------------|
++| `save` | Save current process list |
++| `startup` | Generate startup script |
++| `version` | Get PM2 version |
++
++## 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-pm2 process list
++
++# JSON output for agents
++cli-anything-pm2 --json process 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
++
++## Version
++
++1.0.0
diff --cc pm2/agent-harness/cli_anything/pm2/utils/pm2_backend.py
index 0a1d4c230,000000000..0529b8a5b
mode 100644,000000..100644
--- a/pm2/agent-harness/cli_anything/pm2/utils/pm2_backend.py
+++ b/pm2/agent-harness/cli_anything/pm2/utils/pm2_backend.py
@@@ -1,241 -1,0 +1,239 @@@
+"""PM2 Backend — subprocess wrapper for all PM2 CLI commands.
+
+All PM2 interactions go through this module. It finds the pm2 binary,
+runs commands via subprocess.run(), and returns structured results.
+"""
+
+import json
+import os
+import shutil
+import subprocess
+from typing import Any
+
+
+def _find_pm2() -> str:
+ """Locate the pm2 binary on the system.
+
+ Checks common Homebrew and global npm paths in addition to PATH.
+
+ Returns:
+ Absolute path to the pm2 binary.
+
+ Raises:
+ RuntimeError: If pm2 is not found.
+ """
- # Ensure common paths are in PATH for shutil.which
+ extra_paths = ["/opt/homebrew/bin", "/usr/local/bin", "/usr/bin"]
+ env_path = os.environ.get("PATH", "")
+ for p in extra_paths:
+ if p not in env_path:
+ env_path = f"{p}:{env_path}"
- os.environ["PATH"] = env_path
+
- pm2_path = shutil.which("pm2")
++ pm2_path = shutil.which("pm2", path=env_path)
+ if pm2_path is None:
+ raise RuntimeError(
+ "pm2 not found on this system. "
+ "Install it with: npm install -g pm2"
+ )
+ return pm2_path
+
+
+# Cache the pm2 path at module level
+_PM2_BIN: str | None = None
+
+
+def _get_pm2() -> str:
+ """Get cached pm2 binary path."""
+ global _PM2_BIN
+ if _PM2_BIN is None:
+ _PM2_BIN = _find_pm2()
+ return _PM2_BIN
+
+
+def _build_env() -> dict[str, str]:
+ """Build environment dict with proper PATH for subprocess."""
+ env = os.environ.copy()
+ extra = "/opt/homebrew/bin:/usr/local/bin"
+ if extra not in env.get("PATH", ""):
+ env["PATH"] = f"{extra}:{env.get('PATH', '')}"
+ return env
+
+
+def run_pm2(
+ *args: str,
+ capture_json: bool = False,
+ timeout: int = 30,
+) -> dict[str, Any]:
+ """Run a pm2 command and return the result.
+
+ Args:
+ *args: Arguments to pass to pm2 (e.g., "jlist", "restart", "myapp").
+ capture_json: If True, attempt to parse stdout as JSON.
+ timeout: Command timeout in seconds.
+
+ Returns:
+ Dict with keys:
+ - success (bool): Whether command exited with code 0.
+ - returncode (int): Process return code.
+ - stdout (str): Raw stdout.
+ - stderr (str): Raw stderr.
+ - data (Any): Parsed JSON data if capture_json=True, else None.
+ """
+ pm2 = _get_pm2()
+ cmd = [pm2, *args]
+
+ try:
+ result = subprocess.run(
+ cmd,
+ capture_output=True,
+ text=True,
+ timeout=timeout,
+ env=_build_env(),
+ )
+ except subprocess.TimeoutExpired:
+ return {
+ "success": False,
+ "returncode": -1,
+ "stdout": "",
+ "stderr": f"Command timed out after {timeout}s: {' '.join(cmd)}",
+ "data": None,
+ }
+ except FileNotFoundError:
+ return {
+ "success": False,
+ "returncode": -1,
+ "stdout": "",
+ "stderr": f"pm2 binary not found at: {pm2}",
+ "data": None,
+ }
+
+ parsed_data = None
+ if capture_json and result.returncode == 0:
+ try:
+ parsed_data = json.loads(result.stdout)
+ except (json.JSONDecodeError, ValueError):
+ # stdout may contain non-JSON preamble; try to extract JSON array
+ stdout = result.stdout.strip()
+ # Look for JSON array or object
+ for start_char, end_char in [("[", "]"), ("{", "}")]:
+ idx_start = stdout.find(start_char)
+ idx_end = stdout.rfind(end_char)
+ if idx_start != -1 and idx_end > idx_start:
+ try:
+ parsed_data = json.loads(stdout[idx_start:idx_end + 1])
+ break
+ except (json.JSONDecodeError, ValueError):
+ continue
+
+ return {
+ "success": result.returncode == 0,
+ "returncode": result.returncode,
+ "stdout": result.stdout,
+ "stderr": result.stderr,
+ "data": parsed_data,
+ }
+
+
+def pm2_jlist() -> list[dict[str, Any]]:
+ """Get JSON list of all PM2 processes.
+
+ Returns:
+ List of process info dicts, or empty list on failure.
+ """
+ result = run_pm2("jlist", capture_json=True)
+ if result["success"] and isinstance(result["data"], list):
+ return result["data"]
+ return []
+
+
+def pm2_describe(name: str) -> dict[str, Any] | None:
+ """Get detailed info for a specific process.
+
+ Uses pm2 jlist and filters by name/id, since pm2 describe
+ does not produce JSON output.
+
+ Args:
+ name: Process name or ID.
+
+ Returns:
+ Process description dict, or None on failure.
+ """
+ processes = pm2_jlist()
+ for p in processes:
+ if p.get("name") == name or str(p.get("pm_id")) == str(name):
+ return p
+ return None
+
+
+def pm2_action(action: str, name: str) -> dict[str, Any]:
+ """Run a lifecycle action (restart, stop, delete) on a process.
+
+ Args:
+ action: One of "restart", "stop", "delete".
+ name: Process name or ID.
+
+ Returns:
+ Result dict from run_pm2.
+ """
+ return run_pm2(action, str(name))
+
+
+def pm2_start(script: str, name: str | None = None) -> dict[str, Any]:
+ """Start a new PM2 process.
+
+ Args:
+ script: Path to script or ecosystem file.
+ name: Optional process name.
+
+ Returns:
+ Result dict from run_pm2.
+ """
+ args = ["start", script]
+ if name:
+ args.extend(["--name", name])
+ return run_pm2(*args)
+
+
+def pm2_logs(name: str, lines: int = 20) -> dict[str, Any]:
+ """Get recent logs for a process.
+
+ Args:
+ name: Process name or ID.
+ lines: Number of log lines to retrieve.
+
+ Returns:
+ Result dict from run_pm2.
+ """
+ return run_pm2("logs", str(name), "--lines", str(lines), "--nostream")
+
+
+def pm2_flush(name: str | None = None) -> dict[str, Any]:
+ """Flush logs for a process or all processes.
+
+ Args:
+ name: Process name or ID. If None, flushes all.
+
+ Returns:
+ Result dict from run_pm2.
+ """
+ args = ["flush"]
+ if name:
+ args.append(str(name))
+ return run_pm2(*args)
+
+
+def pm2_save() -> dict[str, Any]:
+ """Save the current PM2 process list."""
+ return run_pm2("save")
+
+
+def pm2_startup() -> dict[str, Any]:
+ """Generate PM2 startup script."""
+ return run_pm2("startup")
+
+
+def pm2_version() -> str:
+ """Get PM2 version string."""
+ result = run_pm2("--version")
+ if result["success"]:
+ return result["stdout"].strip()
+ return "unknown"
diff --cc pm2/agent-harness/setup.py
index 0e7a4727b,000000000..4005295d4
mode 100644,000000..100644
--- a/pm2/agent-harness/setup.py
+++ b/pm2/agent-harness/setup.py
@@@ -1,21 -1,0 +1,44 @@@
+"""Setup for cli-anything-pm2 — CLI harness for PM2 process management."""
+
- from setuptools import setup, find_packages
++from setuptools import setup, find_namespace_packages
+
+setup(
+ name="cli-anything-pm2",
+ version="1.0.0",
++ author="cli-anything contributors",
++ author_email="",
+ description="CLI-Anything harness for PM2 process management",
- author="Velocity Team",
- packages=find_packages(),
++ 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",
- "prompt-toolkit>=3.0",
++ "click>=8.0.0",
++ "prompt-toolkit>=3.0.0",
+ ],
++ extras_require={
++ "dev": [
++ "pytest>=7.0.0",
++ "pytest-cov>=4.0.0",
++ ],
++ },
+ entry_points={
+ "console_scripts": [
+ "cli-anything-pm2=cli_anything.pm2.pm2_cli:main",
+ ],
+ },
++ package_data={
++ "cli_anything.pm2": ["skills/*.md"],
++ },
++ include_package_data=True,
++ zip_safe=False,
+)
diff --cc registry.json
index e493f85ea,3a077da08..68c40d207
--- a/registry.json
+++ b/registry.json
@@@ -269,47 -313,187 +313,229 @@@
"contributor": "Alex-wuhu",
"contributor_url": "https://github.com/Alex-wuhu"
},
+ {
+ "name": "seaclip",
+ "display_name": "SeaClip",
+ "version": "1.0.0",
+ "description": "Kanban board, 6-agent AI pipeline, and issue management via SeaClip-Lite FastAPI + SQLite",
+ "requires": "SeaClip-Lite running at localhost:5200",
+ "homepage": "https://github.com/t4tarzan/cli-anything-seaclip",
+ "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",
+ "category": "project-management",
+ "contributor": "t4tarzan",
+ "contributor_url": "https://github.com/t4tarzan"
+ },
+ {
+ "name": "pm2",
+ "display_name": "PM2",
+ "version": "1.0.0",
- "description": "Node.js process management \u2014 list, start, stop, restart, logs, and metrics via PM2 CLI",
++ "description": "Node.js process management — list, start, stop, restart, logs, and metrics via PM2 CLI",
+ "requires": "PM2 (npm install -g pm2)",
+ "homepage": "https://pm2.keymetrics.io",
+ "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",
+ "category": "devops",
+ "contributor": "t4tarzan",
+ "contributor_url": "https://github.com/t4tarzan"
+ },
+ {
+ "name": "chromadb",
+ "display_name": "ChromaDB",
+ "version": "1.0.0",
- "description": "Vector database operations \u2014 collections, documents, semantic search via ChromaDB HTTP API",
++ "description": "Vector database operations — collections, documents, semantic search via ChromaDB HTTP API",
+ "requires": "ChromaDB server running at localhost:8000",
+ "homepage": "https://www.trychroma.com",
+ "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",
+ "category": "database",
+ "contributor": "t4tarzan",
+ "contributor_url": "https://github.com/t4tarzan"
++ },
+ {
+ "name": "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)",
+ "homepage": "https://musescore.org",
+ "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",
+ "category": "music",
+ "contributor": "tamvicky",
+ "contributor_url": "https://github.com/tamvicky"
+ },
+ {
+ "name": "sketch",
+ "display_name": "Sketch",
+ "version": "1.0.0",
+ "description": "Generate Sketch design files (.sketch) from JSON design specifications via sketch-constructor",
+ "requires": "Node.js >= 16.0.0",
+ "homepage": "https://www.sketch.com",
+ "install_cmd": "cd sketch/agent-harness && npm install && npm link",
+ "entry_point": "sketch-cli",
+ "skill_md": null,
+ "category": "design",
+ "contributor": "zhangxilong-43",
+ "contributor_url": "https://github.com/zhangxilong-43"
+ },
+ {
+ "name": "freecad",
+ "display_name": "FreeCAD",
+ "version": "1.1.0",
+ "description": "Parametric 3D CAD modeling via FreeCAD CLI (258 commands: Part, Sketcher, PartDesign, Assembly, Mesh, TechDraw, Draft, FEM, CAM, and more)",
+ "requires": "FreeCAD >= 1.1 (freecad.org)",
+ "homepage": "https://www.freecad.org",
+ "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",
+ "category": "3d",
+ "contributor": "AlexGabbia",
+ "contributor_url": "https://github.com/AlexGabbia"
+ },
+ {
+ "name": "iterm2",
+ "display_name": "iTerm2",
+ "version": "1.0.0",
+ "description": "Control a running iTerm2 instance — manage windows, tabs, split panes, send text, read output, run tmux -CC, broadcast keystrokes, and configure preferences.",
+ "requires": "iTerm2.app (macOS only)",
+ "homepage": "https://iterm2.com",
+ "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",
+ "category": "devops",
+ "contributor": "voidfreud",
+ "contributor_url": "https://github.com/voidfreud"
+ },
+ {
+ "name": "slay_the_spire_ii",
+ "display_name": "Slay the Spire 2",
+ "version": "1.0.0",
+ "description": "Control the real Slay the Spire 2 game via local STS2_Bridge HTTP API",
+ "requires": "Slay the Spire 2 (Steam) with STS2_Bridge mod enabled",
+ "homepage": "https://github.com/HKUDS/CLI-Anything/tree/main/slay_the_spire_ii",
+ "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",
+ "category": "game",
+ "contributor": "TianyuFan0504",
+ "contributor_url": "https://github.com/TianyuFan0504"
+ },
+ {
+ "name": "rms",
+ "display_name": "Teltonika RMS",
+ "version": "1.0.0",
+ "description": "Device management and monitoring via Teltonika RMS REST API",
+ "requires": "RMS_API_TOKEN",
+ "homepage": "https://rms.teltonika-networks.com",
+ "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",
+ "category": "network",
+ "contributor": "galke",
+ "contributor_url": "https://github.com/galke7"
+ },
+ {
+ "name": "renderdoc",
+ "display_name": "RenderDoc",
+ "version": "0.1.0",
+ "description": "GPU frame capture analysis: pipeline state, shader export, texture inspection, draw call browsing",
+ "requires": "renderdoc (Python bindings from RenderDoc installation)",
+ "homepage": "https://renderdoc.org",
+ "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",
+ "category": "graphics",
+ "contributor": "levishilf",
+ "contributor_url": "https://github.com/levishilf"
+ },
+ {
+ "name": "videocaptioner",
+ "display_name": "VideoCaptioner",
+ "version": "1.0.0",
+ "description": "AI-powered video captioning — transcribe speech, optimize/translate subtitles, burn styled subtitles into video",
+ "requires": "videocaptioner (pip install videocaptioner), ffmpeg",
+ "homepage": "https://github.com/WEIFENG2333/VideoCaptioner",
+ "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",
+ "category": "video",
+ "contributor": "WEIFENG2333",
+ "contributor_url": "https://github.com/WEIFENG2333"
+ },
+ {
+ "name": "intelwatch",
+ "display_name": "Intelwatch",
+ "version": "1.0.0",
+ "description": "Competitive intelligence, M&A due diligence, and OSINT directly from your terminal.",
+ "requires": "Node.js >=18",
+ "homepage": "https://github.com/ashroth/intelwatch",
+ "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",
+ "category": "osint",
+ "contributor": "ashroth",
+ "contributor_url": "https://github.com/ashroth"
+ },
+ {
+ "name": "clibrowser",
+ "display_name": "clibrowser",
+ "version": "0.1.0",
+ "description": "Zero-dependency CLI browser for AI agents with search, extraction, forms, RSS, crawling, auth, and WebMCP support",
+ "requires": "Rust toolchain (cargo) for source install, or manual binary download from GitHub Releases",
+ "homepage": "https://github.com/allthingssecurity/clibrowser",
+ "install_cmd": "cargo install --git https://github.com/allthingssecurity/clibrowser.git --tag v0.1.0 --locked",
+ "entry_point": "clibrowser",
+ "skill_md": null,
+ "category": "web",
+ "contributor": "allthingssecurity",
+ "contributor_url": "https://github.com/allthingssecurity"
+ },
+ {
+ "name": "cloudcompare",
+ "display_name": "CloudCompare",
+ "version": "1.0.0",
+ "description": "3D point cloud and mesh processing: load/save, color ops, normal estimation, Delaunay meshing, noise filtering, ICP registration, connected component segmentation",
+ "requires": "cloudcompare (CloudCompare application installed, e.g. via Flatpak or package manager)",
+ "homepage": "https://cloudcompare.org",
+ "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",
+ "category": "graphics",
+ "contributor": "Taeyoung96",
+ "contributor_url": "https://github.com/Taeyoung96"
+ },
+ {
+ "name": "exa",
+ "display_name": "Exa",
+ "version": "1.0.0",
+ "description": "AI-powered web search and content extraction via the Exa API",
+ "requires": "EXA_API_KEY (free tier at exa.ai)",
+ "homepage": "https://exa.ai",
+ "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",
+ "category": "search",
+ "contributor": "tgonzalezc5",
+ "contributor_url": "https://github.com/tgonzalezc5"
+ },
+ {
+ "name": "godot",
+ "display_name": "Godot Engine",
+ "version": "1.0.0",
+ "description": "Game engine project management, scene editing, export and GDScript execution via Godot 4 headless mode",
+ "requires": "Godot 4.x (godotengine.org)",
+ "homepage": "https://godotengine.org",
+ "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",
+ "category": "gamedev",
+ "contributor": "omerarslan0",
+ "contributor_url": "https://github.com/omerarslan0"
}
]
-}
+}
diff --cc seaclip/agent-harness/cli_anything/seaclip/utils/seaclip_backend.py
index bf2049da4,000000000..f31d050dd
mode 100644,000000..100644
--- a/seaclip/agent-harness/cli_anything/seaclip/utils/seaclip_backend.py
+++ b/seaclip/agent-harness/cli_anything/seaclip/utils/seaclip_backend.py
@@@ -1,144 -1,0 +1,148 @@@
+"""HTTP client for SeaClip-Lite FastAPI backend.
+
+Some endpoints return HTMX partials, not JSON. For those we fall back
+to direct SQLite reads from the SeaClip-Lite database.
+"""
+
+import os
+import sqlite3
+import requests
+from typing import Any
+
+DEFAULT_BASE_URL = "http://127.0.0.1:5200"
- DEFAULT_DB_PATH = "/Users/whitenoise-oc/shrirama/seaclip-lite/seaclip.db"
+
+
+class SeaClipBackend:
+ """Thin HTTP client wrapping the SeaClip-Lite FastAPI endpoints."""
+
+ def __init__(self, base_url: str | None = None, db_path: str | None = None, timeout: int = 30):
+ self.base_url = (
+ base_url
+ or os.environ.get("SEACLIP_URL")
+ or DEFAULT_BASE_URL
+ ).rstrip("/")
- self.db_path = db_path or os.environ.get("SEACLIP_DB") or DEFAULT_DB_PATH
++ self.db_path = db_path or os.environ.get("SEACLIP_DB")
+ self.timeout = timeout
+ self.session = requests.Session()
+
+ # ── helpers ───────────────────────────────────────────────────────
+
+ def _url(self, path: str) -> str:
+ return f"{self.base_url}{path}"
+
+ def _get(self, path: str, params: dict | None = None) -> Any:
+ r = self.session.get(self._url(path), params=params, timeout=self.timeout)
+ r.raise_for_status()
+ return r.json()
+
+ def _post(self, path: str, json: dict | None = None) -> Any:
+ r = self.session.post(self._url(path), json=json, timeout=self.timeout)
+ r.raise_for_status()
+ return r.json()
+
+ def _delete(self, path: str) -> Any:
+ r = self.session.delete(self._url(path), timeout=self.timeout)
+ r.raise_for_status()
+ return r.json()
+
+ # ── health ────────────────────────────────────────────────────────
+
+ def health(self) -> dict:
+ return self._get("/health")
+
+ # ── issues ────────────────────────────────────────────────────────
+
+ def list_issues(
+ self,
+ status: str | None = None,
+ priority: str | None = None,
+ search: str | None = None,
+ limit: int | None = None,
+ ) -> list[dict]:
+ params: dict[str, Any] = {}
+ if status:
+ params["status"] = status
+ if priority:
+ params["priority"] = priority
+ if search:
+ params["search"] = search
+ if limit:
+ params["limit"] = limit
+ return self._get("/api/issues", params=params)
+
+ def create_issue(
+ self, title: str, description: str = "", priority: str = "medium"
+ ) -> dict:
+ return self._post(
+ "/api/issues",
+ json={"title": title, "description": description, "priority": priority},
+ )
+
+ def move_issue(self, issue_id: str, column: str) -> dict:
+ return self._post(f"/api/issues/{issue_id}/move", json={"column": column})
+
+ def update_issue_status(self, issue_id: str, status: str) -> dict:
+ return self._post(f"/api/issues/{issue_id}/status", json={"status": status})
+
+ def delete_issue(self, issue_id: str) -> dict:
+ return self._delete(f"/api/issues/{issue_id}")
+
+ # ── helpers (SQLite) ─────────────────────────────────────────────
+
+ def _query_db(self, sql: str, params: tuple = ()) -> list[dict]:
+ """Run a read-only query against SeaClip-Lite's SQLite database."""
++ if not self.db_path:
++ raise RuntimeError(
++ "SEACLIP_DB environment variable is required for direct database queries. "
++ "Set it to the path of your SeaClip-Lite seaclip.db file."
++ )
+ conn = sqlite3.connect(self.db_path)
+ conn.row_factory = sqlite3.Row
+ try:
+ rows = conn.execute(sql, params).fetchall()
+ return [dict(r) for r in rows]
+ finally:
+ conn.close()
+
+ # ── agents ────────────────────────────────────────────────────────
+
+ def list_agents(self) -> list[dict]:
+ return self._query_db(
+ "SELECT name, role, status, current_issue_id, last_completed_at, last_error, updated_at FROM agents ORDER BY created_at"
+ )
+
+ # ── pipeline ──────────────────────────────────────────────────────
+
+ def start_pipeline(self, issue_id: str, mode: str = "auto") -> dict:
+ return self._post(f"/api/pipeline/{issue_id}/start", json={"mode": mode})
+
+ def pipeline_status(self, issue_id: str) -> dict:
+ return self._get(f"/api/pipeline/{issue_id}/status")
+
+ def resume_pipeline(self, issue_id: str) -> dict:
+ return self._post(f"/api/pipeline/{issue_id}/resume")
+
+ def stop_pipeline(self, issue_id: str) -> dict:
+ return self._post(f"/api/pipeline/{issue_id}/stop")
+
+ # ── scheduler ─────────────────────────────────────────────────────
+
+ def list_schedules(self) -> list[dict]:
+ return self._query_db(
+ "SELECT id, repo, enabled, interval_minutes, target_column, auto_pipeline, pipeline_mode, ai_mode, last_synced_at, issues_synced FROM schedule_configs ORDER BY id"
+ )
+
+ def add_schedule(self, config: dict) -> dict:
+ return self._post("/api/scheduler/add", json=config)
+
+ def sync_schedule(self, schedule_id: str) -> dict:
+ return self._post(f"/api/scheduler/{schedule_id}/sync")
+
+ # ── activity ──────────────────────────────────────────────────────
+
+ def list_activity(self, limit: int | None = None) -> list[dict]:
+ lim = limit or 20
+ return self._query_db(
+ "SELECT event_type, summary, created_at FROM activity_log ORDER BY created_at DESC LIMIT ?",
+ (lim,),
+ )
diff --cc seaclip/agent-harness/setup.py
index 851192450,000000000..a375f4920
mode 100644,000000..100644
--- a/seaclip/agent-harness/setup.py
+++ b/seaclip/agent-harness/setup.py
@@@ -1,23 -1,0 +1,45 @@@
+"""Setup for cli-anything-seaclip — CLI harness for SeaClip-Lite."""
+
- from setuptools import setup, find_packages
++from setuptools import setup, find_namespace_packages
+
+setup(
+ name="cli-anything-seaclip",
+ version="1.0.0",
++ author="cli-anything contributors",
++ author_email="",
+ description="CLI-Anything harness for SeaClip-Lite project management",
- author="Vinayak",
- author_email="[email protected]",
++ 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",
- packages=find_packages(),
+ install_requires=[
- "click",
- "prompt-toolkit",
- "requests",
++ "click>=8.0.0",
++ "prompt-toolkit>=3.0.0",
++ "requests>=2.28.0",
+ ],
++ extras_require={
++ "dev": [
++ "pytest>=7.0.0",
++ "pytest-cov>=4.0.0",
++ ],
++ },
+ entry_points={
+ "console_scripts": [
+ "cli-anything-seaclip=cli_anything.seaclip.seaclip_cli:main",
+ ],
+ },
++ package_data={
++ "cli_anything.seaclip": ["skills/*.md"],
++ },
++ include_package_data=True,
++ zip_safe=False,
+)