@unravel-tech/thing

用于 thing 的 CLI，供编码智能体推送、版本化和共享工件（HTML 页面、Markdown 文档、独立图片和 PDF）。

npm i -g @unravel-tech/thing
thing login                          # defaults to https://usething.ai
thing push report.html --json
thing push notes.md --json           # Markdown gets a styled reader view
thing push chart.png --json          # images and PDFs too

命令

每个命令都接受 --json 以输出机器可读的结果。

可见性值：private、team、anyone-with-link（打印带令牌的分享 URL）、public。

Related MCP server: drop

上下文解析

推送最终进入哪个团队按以下顺序决定：--team 标志 → 工作目录中的 .thing.json → 本地的 thing use 覆盖 → 你的服务器端默认值（thing default）→ 你的个人空间。登录不再绑定团队，因此如果未设置任何覆盖，服务器会选取你的默认值（例如 Unravel 成员的 Unravel 组织）。

MCP

Claude Code、Cursor、Codex 以及任何支持 Model Context Protocol 的工具都可以通过 thing 发布。无需终端登录：在 usething.ai 的“设置”>“令牌”中创建令牌，然后将其粘贴到你的客户端的 MCP 配置中。

{
  "mcpServers": {
    "thing": {
      "command": "npx",
      "args": ["-y", "@unravel-tech/thing", "mcp"],
      "env": { "THING_TOKEN": "paste-your-token-here" }
    }
  }
}

服务器暴露三个工具：push_artifact 用于发布文件或内联内容并返回链接，list_artifacts 用于查看你有哪些工件，whoami 用于检查你正在推送到哪个账户和团队。

如果你已经运行过 thing login，则会使用存储的凭据，THING_TOKEN 可以省略。

需要 Node >= 18 或 Bun。无运行时依赖。