@canra/ cli (英语)
命令行客户端 坎拉语Name,用于记录机器可读规格(图书馆API,协议,数据格式). 获取一个 spec, 用任意语言生成一个执行, 并对照 spec 的测试向量检查 .
在20+节点或Bun上运行. 不需要安装 :
npx @canra/cli search json
npx @canra/cli info canra/json
npx @canra/cli fetch canra/json
图标
或者安装它来得到 canra 命令 :
npm install -g @canra/cli
canra search json
| 命令 | 它会做什么 |
|---|---|
canra search <query> | 搜索登记册 |
canra info <owner>/<name> | 显示 spec 的元数据 |
canra fetch <owner>/<name>[@version] | 下载一个光谱(最新版本或被绑定版本),验证其SHA-256,并将其保存到 .canra/specs/<owner>/<name>/ |
canra outdated [--json] | 检查获取的新版本的规格; 如果有已过时或已隔离, 则退出 1 |
canra update [<owner>/<name>] | 重排每个已过时光谱的最新版本( 或命名的光谱); 如果任何光谱被隔离或无法更新, 则退出 1 |
canra remove <owner>/<name> | 删除从中获取的光谱 .canra/specs/ |
canra login | 保存注册 URL 和 API 令牌 |
canra whoami | 显示您保存的令牌所属的账户 |
canra publish <file.spec.md> [--accepts <suggestion-id>] | 发布 spec( 需要一个符号) ; --accepts 标出所接受类别的建议 |
canra suggest <owner>/<name> --title "..." [--body "..."] [--file <path.spec.md>] | 提议更改您没有的规格( 需要一个符号); --file 附上编辑的完整规格, 所有者作为 diff 加以审查 |
canra logout | 删除已保存的证书 |
canra version 编号 : canra help | 版本和使用 |
<owner> 在任何情况下均为用户或组织名称: Canra/json 财务报告和审定财务报表 canra/json 是同一个 spec, 保存在小写所有者在 .canra/specs/。 。 。 .
销售规格
提交 .canra/ 到源控件。 保存的光谱是您项目执行的光谱版本的记录( 一个版本是准确的和不可改变的) 。 之后 canra update, (中文(简体) ), git diff .canra/ 显示每个规格中的变化.
出版
在 cara.dev – 账户 – API 令牌,选择其权限并过期(canra publish 需求 发布规格),然后:
npx @canra/cli login # paste the token when asked
npx @canra/cli publish my-spec.spec.md
全权证书存于 ~/.canra/config.json。 。 。 .
对于特工
您可能根本不需要CLI :
- 原始光谱下标记 :
https://canra.dev/specs/{owner}/{name}.md - LLMs 的站点索引 :
https://canra.dev/llms.txt - 远程 MCP 服务器( 无认证) :
https://canra.dev/mcp,比如说.claude mcp add --transport http canra https://canra.dev/mcp
API 文档 : https://canra.dev/docs/api (英语)
许可证
麻省理工学院