kitty-hive 0.5.3 → 0.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/README.md +22 -18
  2. package/README.zh.md +22 -18
  3. package/dist/index.js +477 -195
  4. package/dist/index.js.map +1 -1
  5. package/dist/interactive.d.ts +36 -0
  6. package/dist/interactive.js +94 -0
  7. package/dist/interactive.js.map +1 -0
  8. package/package.json +2 -1
package/README.md CHANGED
@@ -334,27 +334,31 @@ npm run test:federation
334
334
 
335
335
  ## CLI
336
336
 
337
+ Run `kitty-hive` for the top-level overview, or `kitty-hive <group>` (e.g. `kitty-hive peer`) to see that group's subcommands. Most commands prompt for missing arguments interactively when run from a TTY; pass all flags to stay scriptable.
338
+
337
339
  ```
338
- kitty-hive serve [--port 4123] [--db path] [-v|-q] Start the server
339
- kitty-hive init <tool> [--port 4123] Write MCP config (claude|cursor|vscode|antigravity|all)
340
- kitty-hive status [--port 4123] Server, agent & team status
341
- kitty-hive agent list List agents
342
- kitty-hive agent rename <old> <new> Rename an agent
343
- kitty-hive agent remove <name-or-id> Remove an agent
344
- kitty-hive peer invite --expose <my-agent> [--url url] Create an invite token (recommended)
345
- kitty-hive peer accept <token> --expose <my-agent> [--url url] Accept an invite token (auto-handshake)
346
- kitty-hive peer add <name> <url> [--expose a,b] [--secret s] Add a peer manually
347
- kitty-hive peer list List peers
348
- kitty-hive peer remove <name> Remove a peer
349
- kitty-hive peer expose <name> --add/--remove <agent> Manage exposed agents
350
- kitty-hive peer set-url <name> <url> Manually update a peer's URL (when auto-sync missed it)
351
- kitty-hive config set <key> <value> Set config (e.g. name)
352
- kitty-hive db clear [--db path] Clear the database
353
- kitty-hive files clean [--days 7] Remove old federation transfer files
354
- kitty-hive tunnel start [--port 4123] Run cloudflared & register URL with the hive
355
- kitty-hive tunnel status [--port 4123] Show currently registered tunnel URL
340
+ kitty-hive serve [--port 4123] [--db path] [-v|-q] Start the MCP server
341
+ kitty-hive init [tool] [--port 4123] Write MCP config (interactive picker if no tool)
342
+ kitty-hive status [--port 4123] Server, agent & team status
343
+
344
+ kitty-hive agent list | rename [old] [new] | remove [name-or-id]
345
+ kitty-hive peer invite [--expose <agent>]
346
+ accept [<token>] [--expose <agent>]
347
+ add [<name>] [<url>] [--expose a,b] [--secret s]
348
+ list
349
+ expose [<name>] [<id1,id2,...> | --clear] View / replace exposed agents
350
+ (TTY → multiselect; non-TTY → show current)
351
+ set-url [<name>] [<url>] Manual URL fix (auto-sync fallback)
352
+ remove [<name>]
353
+ kitty-hive tunnel start [--port 4123] [--name name] Run cloudflared & register URL
354
+ status [--port 4123] Show registered tunnel URL
355
+ kitty-hive config set [key] [value] Set config (e.g. `name`)
356
+ kitty-hive files clean [--days 7] Remove old federation transfer files
357
+ kitty-hive db clear [--db path] Clear the database
356
358
  ```
357
359
 
360
+ `peer expose` / `peer add --expose` only accept agents that actually exist on this hive — typos and remote placeholder IDs are rejected up front.
361
+
358
362
  ## Environment
359
363
 
360
364
  | Variable | Purpose |
package/README.zh.md CHANGED
@@ -333,27 +333,31 @@ npm run test:federation
333
333
 
334
334
  ## 命令行
335
335
 
336
+ 直接 `kitty-hive` 看总览，`kitty-hive <group>`（例如 `kitty-hive peer`）只看该分组的子命令。在 TTY 下，缺失的参数会以交互式 prompt 方式补齐；脚本里把 flag 都传上即可保持非交互。
337
+
336
338
  ```
337
- kitty-hive serve [--port 4123] [--db path] [-v|-q] 启动服务
338
- kitty-hive init <tool> [--port 4123] 写入 MCP 配置（claude|cursor|vscode|antigravity|all）
339
- kitty-hive status [--port 4123] 服务/agent/team 状态
340
- kitty-hive agent list 列出 agent
341
- kitty-hive agent rename <old> <new> 重命名 agent
342
- kitty-hive agent remove <name-or-id> 删除 agent
343
- kitty-hive peer invite --expose <my-agent> [--url url] 生成 invite token（推荐）
344
- kitty-hive peer accept <token> --expose <my-agent> [--url url] 接受 invite，自动握手
345
- kitty-hive peer add <name> <url> [--expose a,b] [--secret s] 手动加 peer
346
- kitty-hive peer list 列出 peer
347
- kitty-hive peer remove <name> 删除 peer
348
- kitty-hive peer expose <name> --add/--remove <agent> 管理 peer 暴露的 agent
349
- kitty-hive peer set-url <name> <url> 手动更新 peer 的 URL（自动同步漏掉时应急）
350
- kitty-hive config set <key> <value> 设置配置（如 name）
351
- kitty-hive db clear [--db path] 清空数据库
352
- kitty-hive files clean [--days 7] 清理过期联邦传输文件
353
- kitty-hive tunnel start [--port 4123] 启动 cloudflared，自动注册 URL 给 hive
354
- kitty-hive tunnel status [--port 4123] 查看当前注册的 tunnel URL
339
+ kitty-hive serve [--port 4123] [--db path] [-v|-q] 启动 MCP server
340
+ kitty-hive init [tool] [--port 4123] 写入 MCP 配置（无 tool 时弹 select）
341
+ kitty-hive status [--port 4123] 服务/agent/team 状态
342
+
343
+ kitty-hive agent list | rename [old] [new] | remove [name-or-id]
344
+ kitty-hive peer invite [--expose <agent>]
345
+ accept [<token>] [--expose <agent>]
346
+ add [<name>] [<url>] [--expose a,b] [--secret s]
347
+ list
348
+ expose [<name>] [<id1,id2,...> | --clear] 查看 / 替换 expose 列表
349
+ （TTY → 多选；非 TTY → 打印当前）
350
+ set-url [<name>] [<url>] 自动同步漏掉时手动改
351
+ remove [<name>]
352
+ kitty-hive tunnel start [--port 4123] [--name name] 启动 cloudflared，自动把 URL 注册给 hive
353
+ status [--port 4123] 查看当前注册的 tunnel URL
354
+ kitty-hive config set [key] [value] 设置配置（如 `name`）
355
+ kitty-hive files clean [--days 7] 清理过期联邦传输文件
356
+ kitty-hive db clear [--db path] 清空数据库
355
357
  ```
356
358
 
359
+ `peer expose` / `peer add --expose` 现在只接受真实存在的本地 agent ID —— 拼错或填了远端 placeholder 都会被直接拒掉。
360
+
357
361
  ## 环境变量
358
362
 
359
363
  | 变量 | 用途 |