📘 Khy-OS 文档站 🧭 新手先读：核心概念

# cli-anything-seaclip

name: "cli-anything-seaclip"
description: >-
Command-line interface for SeaClip-Lite - A stateless CLI for managing issues, pipelines, agents, schedules, and activity on the SeaClip-Lite project management board.

# 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:

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. Error responses include `{"error": "message"}` in JSON mode

## Version#

1.0.0