Guide · Agent skill

How to use the SeaClip-Lite CLI Control agent skill

Updated 2026-10-29 · written with AI from the project's own documentation and checked against our catalogue data

The cli-anything-seaclip skill teaches an AI agent to operate a SeaClip-Lite project management board through a command-line tool instead of a browser. It is aimed at developers and teams who already run a SeaClip-Lite board and want an agent to triage issues, control pipelines or read recent activity. After this guide you will know what the skill does, how to install it, how to ask for things in plain language and which safety points to check first.

SeaClip-Lite CLI ControlHKUDS/CLI-Anything · Apache-2.0 Download the skill

Quick start

1Check prerequisites. Confirm Python 3.10 or newer is installed and that the SeaClip-Lite backend is running at localhost:5200.
2Download and unzip the skill. Download the skill ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder.
3Or upload in the Claude apps. Go to Settings → Capabilities → Skills and upload the ZIP if you use the Claude apps.
4Install the CLI package. From the skill's project folder, run pip install -e . to install cli-anything-seaclip.
5Verify the connection. Run cli-anything-seaclip --json server health and confirm the backend responds.
6Ask for an outcome. Request a task in plain language, such as listing issues, and let the agent run the matching command with JSON output.

What the skill makes the agent do

Once installed, the agent can operate SeaClip-Lite through the cli-anything-seaclip command-line tool. The skill covers five areas of the board: issues, pipeline agents, pipeline runs, sync schedules and the activity feed. It also lets the agent check server health.

The tool talks to the SeaClip-Lite backend over HTTP and reads directly from SQLite. It keeps no local state or session between runs.

Issues: list, create, move, change status and delete
Agents: list pipeline agents
Pipeline: start, check status, resume or stop a run
Scheduler: list schedule configs, add a schedule and trigger a sync
Activity: read the recent activity feed
Server: check backend health

Install the skill in Claude

Download the skill ZIP from this page and unzip it into one of two locations. Use ~/.claude/skills/ to make the skill available across your projects, or use a project's .claude/skills/ folder to limit it to that project.

You can also upload the ZIP in the Claude apps under Settings → Capabilities → Skills. The skill's files include SKILL.md.

Personal: unzip into ~/.claude/skills/
Per project: unzip into the project's .claude/skills/ folder
Claude apps: Settings → Capabilities → Skills, then upload the ZIP

Install the command-line tool

The skill needs the cli-anything-seaclip package. The source instructs you to install it from the repository with pip in editable mode, from the skill's project folder. You need Python 3.10 or newer, and a SeaClip-Lite backend running at localhost:5200 before any command will work.

Check the install with the help flag.

Python 3.10 or newer is required
The SeaClip-Lite backend must be running at localhost:5200

pip install -e .
cli-anything-seaclip --help

Trigger the skill with natural requests

You do not need to type commands yourself. Ask the agent for the outcome you want, such as listing open issues or checking whether a pipeline is still running. The agent chooses the matching cli-anything-seaclip command and asks for JSON output so it can read the results reliably.

The source says the CLI can also run as an interactive REPL with tab-completion and history if you start it without a subcommand. Agents use the non-interactive form with --json.

"List the high-priority issues on the SeaClip-Lite board."
"Check the health of the SeaClip-Lite server."
"Show me the last 20 activity entries."
"What is the status of the pipeline for issue <UUID>?"

cli-anything-seaclip --json server health
cli-anything-seaclip --json issue list
cli-anything-seaclip --json agent list

Common commands and flags

The source lists the following options. Flags on each command are shown in brackets.

Pipeline start takes an issue UUID and a mode of auto or manual. Scheduler add takes a name, a cron expression and a repo.

issue list: --status, --priority, --search, --limit
issue create: --title, --description, --priority
issue move: ISSUE_ID --column COL
issue status: ISSUE_ID --set STATUS
issue delete: ISSUE_ID
pipeline start: --issue UUID --mode auto/manual
pipeline status, resume, stop: --issue UUID
scheduler add: --name, --cron, --repo
scheduler sync: SCHEDULE_ID
activity list: --limit N

cli-anything-seaclip --json issue list --status open --limit 10
cli-anything-seaclip --json pipeline start --issue <UUID> --mode manual

Safety: scripts, network and destructive commands

This skill runs scripts and uses the network. It sends requests to the SeaClip-Lite backend at localhost:5200. Review what the agent plans before it runs anything that changes the board.

Delete and status commands act immediately. Deleting an issue removes it, and stopping a pipeline halts a run that is in progress. Ask the agent to list and confirm the target before it runs these commands on a live board.

Runs scripts: yes
Uses network: yes
Delete and status changes take effect immediately
Pipeline stop halts a running pipeline
Use manual pipeline mode if you want to start runs yourself

Tips for reliable results

Ask the agent to use JSON output, which the skill already requests. The source says the tool returns a return code of 0 for success and a non-zero code for errors, and that error responses in JSON mode include an error message. Ask the agent to check the return code and read the error message if a command fails.

Test on a non-critical board first, and confirm the backend is healthy before running larger batches of commands.

Run server health first to confirm the backend is up
Ask for a list before any move, status change or delete
Errors come back as {"error": "message"} in JSON mode

What people use it for

Triage: have an agent list open high-priority issues and summarise them.
Issue updates: move or change the status of issues after you confirm the list.
Pipeline monitoring: check whether a pipeline for a given issue is still running or paused.
Scheduled syncs: add a schedule with a cron expression and a repo, or trigger a sync by schedule ID.
Activity reports: pull the last set of activity entries and write a short report.

Frequently asked questions

How do I install the cli-anything-seaclip skill?

Download the skill ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder. You can also upload the ZIP in the Claude apps under Settings → Capabilities → Skills. The command-line package is installed separately with pip install -e . from the project folder.

What do I need to run the SeaClip-Lite CLI skill?

You need Python 3.10 or newer, the cli-anything-seaclip package installed with pip, and a SeaClip-Lite backend running at localhost:5200. Without the backend the tool cannot do anything.

Is the cli-anything-seaclip skill free?

The skill is published under the Apache-2.0 licence. Check the licence file in the repository for the terms that apply to your use.

Can the agent delete issues or stop pipelines by mistake?

It can, because delete and status commands act immediately. Deleting removes an issue and stopping halts a running pipeline. Ask the agent to list the target and confirm before running these commands on a live board.

Why does the agent use --json?

The skill's instructions tell the agent to always use the --json flag so output is structured and easy to parse. Errors in JSON mode include an error message, and the agent should check the return code, where 0 means success.

Does this skill work without SeaClip-Lite?

No. The tool communicates with a SeaClip-Lite backend at localhost:5200 over HTTP and reads from SQLite. If that backend is not running, the commands will not work.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use this skill if you already run a SeaClip-Lite board locally and want an agent to triage issues, check pipelines or report on activity. Pick something else if you do not have the backend at localhost:5200, or if you want changes to a live board made without review, since delete and stop commands act immediately.

Download the skill