cli-anything-seaclip

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

cli-anything-seaclip

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.
一款面向SeaClip-Lite项目管理的无状态命令行界面。通过HTTP API和直接读取SQLite数据库进行通信,无需本地状态或会话。

Installation

安装

bash
pip install -e .
Prerequisites:
  • Python 3.10+
  • SeaClip-Lite backend running at localhost:5200
bash
pip install -e .
前置要求:
  • Python 3.10+
  • SeaClip-Lite后端服务运行在localhost:5200

Usage

使用方法

Basic Commands

基础命令

bash
undefined
bash
undefined

Show help

显示帮助信息

cli-anything-seaclip --help
cli-anything-seaclip --help

Start interactive REPL mode

启动交互式REPL模式

cli-anything-seaclip
cli-anything-seaclip

Run with JSON output (for agent consumption)

以JSON格式输出(供Agent调用)

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

REPL Mode

交互式REPL模式

When invoked without a subcommand, the CLI enters an interactive REPL session:
bash
cli-anything-seaclip
当不指定子命令调用时,CLI会进入交互式REPL会话:
bash
cli-anything-seaclip

Enter commands interactively with tab-completion and history

可交互式输入命令,支持补全和历史记录

undefined
undefined

Command Groups

命令组

Issue

Issue(任务)

Issue management commands.
CommandDescription
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)
任务管理命令。
命令描述
list
列出任务(支持参数:--status、--priority、--search、--limit)
create
创建新任务(支持参数:--title、--description、--priority)
move
将任务移动到指定列(需传入ISSUE_ID,参数--column COL)
status
更新任务状态(需传入ISSUE_ID,参数--set STATUS)
delete
删除任务(需传入ISSUE_ID)

Agent

Agent

Pipeline agent commands.
CommandDescription
list
List all pipeline agents
流水线Agent命令。
命令描述
list
列出所有流水线Agent

Pipeline

Pipeline(流水线)

Pipeline control commands.
CommandDescription
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)
流水线控制命令。
命令描述
start
启动流水线(支持参数:--issue UUID、--mode auto/manual)
status
获取流水线状态(支持参数:--issue UUID)
resume
恢复暂停的流水线(支持参数:--issue UUID)
stop
停止运行中的流水线(支持参数:--issue UUID)

Scheduler

Scheduler(调度器)

Schedule configuration commands.
CommandDescription
list
List all schedule configs
add
Add schedule (--name, --cron, --repo)
sync
Trigger sync (SCHEDULE_ID)
调度配置命令。
命令描述
list
列出所有调度配置
add
添加调度计划(支持参数:--name、--cron、--repo)
sync
触发同步(需传入SCHEDULE_ID)

Activity

Activity(活动记录)

Activity feed commands.
CommandDescription
list
Recent activity (--limit N)
活动流命令。
命令描述
list
查看最近活动记录(支持参数:--limit N)

Server

Server(服务器)

Server utility commands.
CommandDescription
health
Check backend health
服务器实用命令。
命令描述
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
bash
undefined
所有命令支持两种输出模式:
  • 人类可读格式(默认):表格、彩色文本、格式化内容
  • 机器可读格式
    --json
    参数):结构化JSON,供Agent调用
bash
undefined

Human output

人类可读格式输出

cli-anything-seaclip issue list
cli-anything-seaclip issue list

JSON output for agents

供Agent调用的JSON格式输出

cli-anything-seaclip --json issue list
undefined
cli-anything-seaclip --json issue list
undefined

For AI Agents

面向AI Agent的使用说明

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
当以编程方式使用该CLI时:
  1. 务必使用
    --json
    参数
    以获得可解析的输出
  2. 检查返回码 - 0表示成功,非0表示错误
  3. 解析stderr以获取错误信息(当执行失败时)
  4. 错误响应在JSON模式下会包含
    {"error": "message"}
    字段

Version

版本

1.0.0
1.0.0