锡那拉语name

命令行工具用于 锡纳特拉 ——团队的开源AI工作空间,人们,AI助手,以及自主代理在持久工作流程上合作.

用它来站起你自己的Cinatra实例,并保持它运行——从一个本地的dev setup到生产.

快开始

npx @cinatra-ai/cinatra install

从零开始设置 Cinatra 实例:检查您的前提条件,获取 Cinatra , 创建您的环境, 启动本地服务, 并运行首次设置 。 之后,从你的Cinatra目录中运行其他命令.

安装

根据要求,不需要安装 :

npx @cinatra-ai/cinatra <command>

或者在全球安装( 那么命令就是 cinatra:

npm install -g @cinatra-ai/cinatra

需要节点.js >= 24.

尽你所能

cinatra install --mode dev       # set up OR reconcile a dev instance (single entrypoint)
cinatra install --mode prod      # set up OR reconcile a production instance
cinatra status                   # check an instance's status
cinatra doctor                   # diagnose your local setup
cinatra agents install <name>    # add an agent to your instance
cinatra create-extension <kind>  # scaffold a new extension to author

cinatra install --mode dev|prod 是单一的同位素命令 实例存在或使其健康:用干净的机器运行,从 抓取, 或重新运行到已有的取出中以调节它( 它跳过克隆) 并重新运行 收买供给阶段—— 没有单独的 setup 命令要记住).

另一个本地主机/Monorepo靴子 命令您从 Cinatra 内部运行 退房现场 cinatra instance …数字 :

cinatra instance db migrate           # apply schema updates (works when the app is down)
cinatra instance branch setup         # provision an isolated env for the current worktree
cinatra instance branch teardown --yes  # drop that worktree's isolated schema
cinatra instance clone new <name>     # create an isolated deep-fork clone
cinatra instance refresh              # reconcile deps + dev DB to your checkout
cinatra instance tunnel start         # manage the dev Tailscale Funnel
cinatra instance backup create        # take a local backup bundle
cinatra instance reset --yes          # reset the development environment

运行 cinatra --help 用于顶级命令列表,或 cinatra instance --help 用于完整本地波茨图指令列表.

运行不止一个实例

如果你已经有一个 Cinatra 实例运行 cinatra install 发现它的 在使用的港口,它不仅停止——它告诉你谁拥有港口和提议 为你设立二审 在它问的终端上,您也可以选择 选项前方有标记 :

cinatra install --on-conflict=isolated   # a second, fully separate instance
                                          # on its own ports + app port
cinatra install --on-conflict=stop-existing  # stop the existing one first,
                                              # then install on the default ports
cinatra install --on-conflict=attach     # re-use / update the existing checkout
cinatra install --on-conflict=co-use     # share the running instance's services
                                         # (separate database + queue; no 2nd stack)
cinatra install --infra=external \       # point at your own database/cache
    --db-url <url> --redis-url <url> --nango-url <url> --graphiti-url <url> \
    --external-db-disposable             # confirm the external DB is disposable
                                         # (setup may write to it; required for --db-url)

有用的额外项目 :

cinatra install --instance <name>        # name the instance (default: the folder name)
cinatra install --app-port <n>           # pick the app port for an isolated instance
cinatra install --port-offset auto|<n>   # how far to shift an isolated instance's ports
cinatra install --dry-run                # show what would happen, change nothing
cinatra install --list-instances         # list the instances you have set up
cinatra install --status [--dir <path>]  # show one checkout's instance state
cinatra install --resume                 # finish an install that was interrupted

--list-instances 编号 : --status 只读。 停止或擦去已有的 案例总是首先要求确认; --yes 单独从不删除数据 (并指自己外部数据库中的设置) --db-url 同样需要 明确 --external-db-disposable 承认——一无所有 --yes 不会的 它,因为设置可以写到数据库.

合用(共享一集服务). --on-conflict=co-use 编号 : --infra=share 运行一个二审 针对第一个运行的服务 ——它自己的应用端口和自己的数据库,但相同的Postgres服务器Redis, 和南戈(没有第二个多克堆)。 仅在安装的应用程序时启用 每个实例隔离登录 cookie( 否则两例在 localhost 将分享一会,所以 cinatra install 以精确的应用程序更改拒绝 需要并标注 --on-conflict=isolated) (中文(简体) ). 当捐助方设定 图形 URL, 添加 --allow-shared-graphiti 接受分享(这是 org-classed, not per-instance.)),是一款有眼力的活体.

作者扩展名

脚手架 即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用 类型(agent, (中文(简体) ), connector, (中文(简体) ), artifact, (中文(简体) ), skill, (中文(简体) ), workflow:

cinatra create-extension agent invoice-extractor

它产生一个完整、独立的回波(明显、README、CI、等同门和 特定种类的有效载荷。 生成的包针 @cinatra-ai/sdk-extensions 作为可选的对等点;没有为您安装任何设备。 运行 cinatra create-extension --help 对于种类和选择.

Repo 结构

bin/              Entry-point script (cinatra.mjs)
src/              CLI source modules
  authoring/      Extension scaffolding core (create-extension)
templates/        Scaffold templates for each extension kind
  agent/
  artifact/
  connector/
  skill/
  workflow/
  _shared/        Shared files copied into every generated extension
tests/            Vitest test suite

这回波是 薄的中央液态 只有这个 没有 @cinatra-ai/* 运行时间 依赖性——这些依赖性通过操作员的Cinatra检查解决 运行时间。 迁移跑者, dev-app 运算表和第一党 SDK 包 都来自离职,不是这个包.

发展

复制并安装依赖性 :

git clone https://github.com/cinatra-ai/cinatra-cli.git
cd cinatra-cli
npm ci

运行测试套件 :

npm test

这套套房由 维特 并盖住电流, 克隆/登记逻辑、扩展脚手架、命令调度和启动 合同。 需要Cinatra检查的测试使用合成假检查 国家 tests/helpers/setup-fake-checkout.mjs; 没有真实实例 需要运行测试.

在当地检查CLI:

node bin/cinatra.mjs --help
node bin/cinatra.mjs --version

CI管道.github/workflows/ci.yml在每个 拉出请求:依赖性断言,全Vitest套房,两种烟雾 检查,和干燥包 验证公布的有效载荷.

投稿时,要铭记薄的CLI约束:不要添加 @cinatra-ai/* 软件包到 dependencies, (中文(简体) ), devDependencies,或 peerDependencies。如果出现任何第一党包,CI将拒绝 PR 在表里或经结的依附树上.

解决问题

cinatra: command not found 全局安装后 请检查npm的全球 bin 目录在您的 PATH数字 :

npm prefix -g       # prints the global prefix (e.g. /usr/local)
echo $PATH          # verify <prefix>/bin appears here

如果缺少,请添加 $(npm prefix -g)/bin 切入到您的外壳配置 (例如:. ~/.zshrc 或者说 ~/.bashrc) (中文(简体) ).

cinatra install 表示正在使用端口 另一个 Cinatra 实例( 或另一种服务) 已经在使用默认 端口。 使用 --list-instances 以查看运行中的内容 :

cinatra install --list-instances

然后选择一个决议: --on-conflict=isolated 启动二审 自己的港口乐队, --on-conflict=attach 重新附在现有的结账, 或者说 --on-conflict=stop-existing 在安装前停止现有堆栈.

cinatra doctor 诊断破损实例 如果你的行为不端, cinatra doctor 检查您的本地设置 报告什么是错。 在提交一个问题之前先运行它.

节点.js 版本错误 CLI要求节点.js 24或后. 检查您的版本 node --version 并在需要时升级.

更改日志

见 变动情况 以完整的历史释放.

许可证

阿帕奇 - 2.0