cli-contexts

用途

cli-contexts 是 OmniRoute 命令行工具中面向上下文工程（context engineering）的一组子命令，用于管理上下文工程配置、RTK 过滤器集合以及对话会话。它可以在终端中应用 context-relay 设置，并检查当前生效的上下文管道。

安装与运行

npm install -g omniroute   # or: npx omniroute
omniroute --version

主要命令族

context-eng

用于上下文工程相关配置与检查，包含以下子命令：

• context-eng：基础入口。
• context-eng analytics：支持 --period <p> 参数。
• context-eng caveman。
• context-eng config。
• context-eng show。
• context-eng set：支持 --aggressiveness <n>、--max-shrink-pct <n>、--preserve-tags <list> 参数。
• context-eng rtk：其下同样包含 config、show、set 子命令，set 支持 --token-budget <n>、--reserve-pct <n> 参数。
• context-eng filters：其下包含 list、add（支持 --pattern <p>、--priority <n>、--action <a>）、remove <id>（支持 --yes）、test（支持 --file <path>）、raw-output <id>。
• context-eng combos：其下包含 list、get <id>、assignments <id>。

contexts

用于管理上下文（服务器、认证、作用域等）：

• contexts list：列出所有上下文。
• contexts add <name>：新增上下文，支持 --url <u>、--api-key <k>、--api-key-stdin、--access-token <t>、--access-token-stdin、--scope <s>、--description <d>。
• contexts use <name>：切换当前活动上下文。
• contexts current：显示当前活动上下文（服务器、认证、作用域），支持 --name-only。
• contexts show <name>：显示上下文详情。
• contexts remove <name>：删除上下文，支持 --yes。
• contexts rename <old> <new>：重命名上下文。
• contexts export：导出上下文为 JSON，支持 --out <path>、--no-secrets、--include-secrets。
• contexts import <file>：从 JSON 文件导入上下文，支持 --merge。
• contexts migrate：将旧版明文上下文凭据迁移到操作系统钥匙串，支持 --yes。

sessions

用于管理对话会话：

• sessions list：支持 --user <u>、--kind <k>、--active、--limit <n>。
• sessions show <sessionId>。
• sessions expire <sessionId>：支持 --yes。
• sessions expire-all：支持 --user <u>、--yes。
• sessions current。

适用场景

适合需要在命令行中检查、调整上下文压缩与令牌预算策略，管理多套上下文连接配置，以及查看或清理会话的开发者与运维人员。

限制

资料未提供该工具的收费、价格、平台支持范围、性能效果等具体信息，暂未提供。