CLI Anything Seaclip

Productivity

cli-anything-seaclip

CLI Anything Seaclip is an Agent Skill for productivity published in the HKUDS/CLI-Anything repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Command-line interface for SeaClip-Lite - A stateless CLI for managing issues, pipelines, agents, schedules, and activity on the SeaClip-Lite project management board.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/HKUDS/CLI-Anything/blob/HEAD/skills/cli-anything-seaclip/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/cli-anything-seaclip, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

cli-anything-seaclip

A stateless command-line interface for SeaClip-Lite project management. Communicates via HTTP API and direct SQLite reads. No local state or session.

Installation

pip install -e .

Prerequisites:

Python 3.10+
SeaClip-Lite backend running at localhost:5200

Usage

Basic Commands

# Show help
cli-anything-seaclip --help

# Start interactive REPL mode
cli-anything-seaclip

# Run with JSON output (for agent consumption)
cli-anything-seaclip --json server health
cli-anything-seaclip --json issue list
cli-anything-seaclip --json agent list

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

cli-anything-seaclip
# Enter commands interactively with tab-completion and history

Command Groups

Issue

Issue management commands.

Command	Description
`list`	List issues (--status, --priority, --search, --limit)
`create`	Create a new issue (--title, --description, --priority)
`move`	Move issue to column (ISSUE_ID --column COL)
`status`	Update issue status (ISSUE_ID --set STATUS)
`delete`	Delete an issue (ISSUE_ID)

Agent

Pipeline agent commands.

Command	Description
`list`	List all pipeline agents

Pipeline

Pipeline control commands.

Command	Description
`start`	Start pipeline (--issue UUID --mode auto/manual)
`status`	Get pipeline status (--issue UUID)
`resume`	Resume paused pipeline (--issue UUID)
`stop`	Stop running pipeline (--issue UUID)

Scheduler

Schedule configuration commands.

Command	Description
`list`	List all schedule configs
`add`	Add schedule (--name, --cron, --repo)
`sync`	Trigger sync (SCHEDULE_ID)

Activity

Activity feed commands.

Command	Description
`list`	Recent activity (--limit N)

Server

Server utility commands.

Command	Description
`health`	Check backend health

Output Formats

All commands support dual output modes:

Human-readable (default): Tables, colors, formatted text
Machine-readable (--json flag): Structured JSON for agent consumption

# Human output
cli-anything-seaclip issue list

# JSON output for agents
cli-anything-seaclip --json issue list

For AI Agents

When using this CLI programmatically:

Always use --json flag for parseable output
Check return codes - 0 for success, non-zero for errors
Parse stderr for error messages on failure
Error responses include {"error": "message"} in JSON mode

Version

1.0.0