@the-librarian/cli - - - librarian 安装程序
一个小的CLI，为
图书馆员: it 把它连接到
你的人工智能代理 （为所有线束安装/更新该集成）
你的机器)和 自托管服务器 他们交谈 (server up /
update）. 可以把它看作是library设置的包管理器：一个工具
你继续，驾驶每个安全带 本地的 安装路径，而不是手工编辑
五种配置格式。
利用它管理： Claude代码，Codex，OpenCode，Hermes，Pi. 为 服务器端，参见 自行托管服务器.
安装
直接从npm中运行 npx -不需要全局安装：
npx @the-librarian/cli install
更喜欢持久性命令？全局安装一次并调用 librarian
直接:
npm i -g @the-librarian/cli
librarian install
就是这样——你要安装的任何线束都已经有Node了，所以没有
引导脚本。 librarian install 不带参数打开交互
针对您的MCP URL令牌进行多选并提示一次; 将线束id传递给
针对特定的。随时重新运行它以添加线束。
命令
librarian install [harness…] Install into one or more harnesses
(no args → interactive multi-select; prompts
for MCP URL + token once)
librarian uninstall [harness…] Remove The Librarian from each harness
librarian update [harness…] Update the integration to the current version
librarian status Live table: harness · installed · version
librarian doctor Token set? server reachable? which harness CLIs?
librarian config Show or set MCP URL, token, server URL
librarian self-update Update the CLI itself (coming in a later release)
librarian report Push this machine's state to the server
(coming in a later release)
librarian server up Self-host the server with Docker; prints the
MCP URL + agent token to paste into `install`
librarian server update Upgrade the server to the latest release
(pulls before stop; data/config are preserved)
librarian server down|status|logs Stop / inspect / tail the running server
有用的标志： --mcp-url <url>， --token <token> (从来没有印刷),
--shell <bash|zsh|fish> 要覆盖外壳检测， -h/--help，
-v/--version． 利用id: claude， codex， opencode， hermes， pi． 一个
报告未安装CLI的线束 not-detected 并跳过-不
一个错误。
自行托管服务器
图书馆员需要一个服务器来交谈。 server up 与Docker站在一起-
它解析最新的稳定版本，提取并验证准确发布的版本
图像，运行其不可变的消化，铸币你的秘密，等待健康，并打印
MCP URL +要粘贴的代理令牌 librarian install． 稳定安装需求
Docker而不是Git；通过 --ref main （或其他发展参考）使用
Git支持的源检出和本地构建路径:
npx @the-librarian/cli server up
要关闭自动全新安装的第一所有者设置窗口，请arm a 创建时的一次性所有者声明:
LIBRARIAN_BOOTSTRAP_CLAIM_SECRET="$(openssl rand -base64 48)" \
npx @the-librarian/cli server up
librarian server admin auth mint-claim --email [email protected]
该秘密将被验证并仅存储在托管中 0600 部署env-file;
server update 保存它。看到
self-host指南
完整的索赔和赔偿仪式。
默认情况下，仓库位于docker管理的命名卷(librarian_data）。
将数据保存在路径中 你 选择，这样你就可以备份，把它放在
特定磁盘，或在主机之间移动它-通过 --data-dir：
npx @the-librarian/cli server up --data-dir /srv/librarian
与 --data-dir，服务器绑定挂载该目录 /data 并运行
容器 作为目录的所有者,所以金库归-和
可写的-你，而不是一个容器用户。如果没有，则创建目录
存在, server update 自动重用它。（--data-dir 和
--data-volume 是相互排斥的。)
如果策展人的法学硕士只能通过网络访问，则不通过 --dns 100.100.100.100
在 server up 或者 server update (后者的作品，即使当图像
已经电流)。名称服务器以部署状态记录，以便以后更新
留着吧。Compose堆栈使用 LIBRARIAN_DNS 代替。
其他服务器命令: server update 在停止旧的之前提取并验证
容器，保存存储，端口，凭证，重启策略，操作器DNS
（--dns) 和部署状态。一个失败的替换恢复和健康检查以前的可执行文件；
如果迁移开始，则会显式显示持久性数据更改 不 声称为
回滚。 server status 将部署标记为已发布 (带有简短的
摘要)、源或遗留。 server down / logs 和 server enable-boot
(Linux systemd) 完成生命周期。在专用网络/后面运行它
VPN，或使用auth公开它-请参阅
部署指南.
托管服务器文件位于 ~/.librarian/server 默认情况下:
deploy.env 是保护模式 0600，而 deploy-state.json 只包含
非秘密配置和图像来源。稳定的注册中心/网络/认证/
架构失败是教学错误，永远不会触发源代码构建
回退。的部署时，将保留现有的源签出
已发布的图像。
它向您的环境写入的内容
命令行可以控制一切 ~/.librarian/：
-
~/.librarian/env-一个POSIX环境文件 (chmod 600（仅由所有者持有） 你的两个秘密:export LIBRARIAN_MCP_URL="…" export LIBRARIAN_AGENT_TOKEN="…" -
~/.librarian/machine-id-第一次运行时生成的UUID，因此相同 不同计算机上的设置在仪表板中保持不同。
它增加了 一个 到shell rc (~/.bashrc /
~/.zshrc) 来源的env文件:
# >>> librarian >>>
[ -f "$HOME/.librarian/env" ] && . "$HOME/.librarian/env"
# <<< librarian <<<
Fish无法获取POSIX文件，所以它只能获取本地文件
~/.config/fish/conf.d/librarian.fish 与 set -gx。重新运行任何命令
替换块-它永远不会重复。 librarian config 重写
~/.librarian/env.
安全
您的代理令牌是凭据。CLI对待它像一个:
- 这是写 只有 来
~/.librarian/env，也就是chmod 600（所有者只读/写）-永远不会提交或全球可读的文件。 - 它是 从未打印过 (不在
status，doctor，config（或日志）和 从不放入URL-持有者令牌在标头中传播到配置的 服务器，通过配置的URL，而不是其他任何地方。
如果你需要旋转它，重新运行 librarian config --token <new> (或编辑
~/.librarian/env 直接地）。
避免
--token <value>在共享或审核的计算机上。 传递的值 命令行对任何可以运行ps当命令运行时， 它落在你的贝壳历史中。更喜欢在输入令牌 交互式提示-librarian install读它的回声 柔和的,所以 它永远不会出现在屏幕上，在ps，或在历史-或编辑chmod 600~/.librarian/env直接文件。