mcpField
C
cli-anything-seaclip

cli-anything-seaclip

github.com/hkuds生产力57.6k460 次安装5 周前更新
代码仓库

关于 cli-anything-seaclip

cli-anything-seaclip 是用于管理 SeaClip-Lite 项目的无状态命令行工具,通过 HTTP API 和直接读取 SQLite 运作。它涵盖问题、流水线、计划配置和活动记录,并支持 JSON 自动化输出。

主要功能

  1. 01管理问题及其状态
  2. 02启动和控制流水线
  3. 03配置并同步计划
  4. 04查看 Agent 和近期活动
  5. 05用于自动化的 JSON 输出

适用场景

  1. 01在终端创建项目问题并调整其状态
  2. 02启动或恢复问题流水线
  3. 03设置定时仓库同步

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-seaclip

安装后在 Claude Code 中输入/cli-anything-seaclip确认已加载。

详细介绍

cli-anything-seaclip

一个用于 SeaClip-Lite 项目管理的无状态命令行界面。 通过 HTTP API 和直接读取 SQLite 进行通信。无本地状态或会话。

安装

pip install -e .

前置条件:

  • Python 3.10+
  • 运行在 localhost:5200 的 SeaClip-Lite 后端

用法

基本命令
# 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 模式

在不带子命令调用时,CLI 会进入交互式 REPL 会话:

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

命令组

Issue

Issue 管理命令。

命令描述
list列出 issue(--status、--priority、--search、--limit)
create创建新 issue(--title、--description、--priority)
move将 issue 移动到列(ISSUE_ID --column COL)
status更新 issue 状态(ISSUE_ID --set STATUS)
delete删除 issue(ISSUE_ID)
Agent

流水线 Agent 命令。

命令描述
list列出所有流水线 Agent
Pipeline

流水线控制命令。

命令描述
start启动流水线(--issue UUID --mode auto/manual)
status获取流水线状态(--issue UUID)
resume恢复已暂停的流水线(--issue UUID)
stop停止正在运行的流水线(--issue UUID)
Scheduler

调度配置命令。

命令描述
list列出所有调度配置
add添加调度(--name、--cron、--repo)
sync触发同步(SCHEDULE_ID)
Activity

活动动态命令。

命令描述
list最近活动(--limit N)
Server

服务器实用命令。

命令描述
health检查后端健康状态

输出格式

所有命令都支持两种输出模式:

  • 人类可读(默认):表格、颜色、格式化文本
  • 机器可读(--json 标志):供 Agent 使用的结构化 JSON
# Human output
cli-anything-seaclip issue list

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

面向 AI Agent

以编程方式使用此 CLI 时:

  1. 始终使用 --json 标志以获得可解析的输出
  2. 检查返回码 - 0 表示成功,非零表示错误
  3. 在失败时解析 stderr 以获取错误消息
  4. 错误响应在 JSON 模式下包含 {"error": "message"}

版本

1.0.0

评论

支持 Markdown