DOCUMENTATION

围绕 真实 CLI 命令面 写文档

本页内容来自 `popiartcli` README、当前状态文档和命令树,不使用想象中的未来命令。

INSTALL

安装方式

`popiartcli` 当前 README 已经明确列出 Homebrew、curl/install.sh、PowerShell 与 source build 四条安装路径。

Homebrew
brew tap wtgoku-create/popi
brew install wtgoku-create/popi/popiart
popiart bootstrap --agent codex --discoverable
Source Build
git clone https://github.com/wtgoku-create/popiartcli.git
cd popiartcli
go install ./cmd/popiart
popiart --help
QUICK START

快速开始

最小闭环是:安装 CLI、登录、发现 skill、运行任务、轮询 jobs、拉取 artifacts。

Quick Start
popiart auth login --key pk-...
popiart skills list --tag image
popiart run popiskill-image-text2image-basic-v1 --input @params.json --wait
popiart jobs get job_xxx
popiart artifacts pull art_xxx
COMMAND GROUP

Core Commands

  • auth 管理身份验证和 API key
  • skills 发现、安装和查看 skill schema
  • run 调用一个 skill 并返回 `job_id`
  • jobs 查询和等待作业状态
  • artifacts 拉取作业产物
COMMAND GROUP

Platform Commands

  • budget 查看令牌使用情况和剩余预算
  • project 管理当前项目上下文
  • models 查询模型路由与直接推理能力
  • bootstrap 生成本地 discoverability 资产
  • update 从 GitHub Releases 下载新版本
MCP

MCP discoverability 已落地的部分

当前 repo 已实现 `popiart mcp serve / print-config / doctor`,并暴露一套可调用的 tool surface。

MCP
popiart mcp serve --describe
popiart mcp print-config
popiart mcp doctor
popiart bootstrap --agent codex --discoverable
  • Implemented tools: list_skills, get_skill, run_skill, get_job, wait_job, pull_artifact
  • Not done yet: MCP resources / prompts / sampling
RUNTIME BASELINE

当前官方执行基线

`popiartcli` 当前状态文档明确只把三个 skill 视为官方 runtime baseline,它们是官网和控制台里最适合优先展示的可执行能力。

  • popiskill-image-text2image-basic-v1
  • popiskill-image-img2img-basic-v1
  • popiskill-video-image2video-basic-v1