@milisp/keke 0.1.9 → 0.1.11

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.
package/README.md CHANGED
@@ -5,15 +5,12 @@
5
5
  keke is a local terminal coding agent built for zero-vendor lock-in.
6
6
  Works with subscriptions you already have, standard API keys, or self-hosted local models.
7
7
 
8
- **Status: early (v0.1.x), usable day to day.** Good fit for personal daily
9
- driving, scripted/CI use, and small-team trials. Not yet the right choice for
10
- a regulated or uninterruptible production pipeline — see
11
- [Production & safety](#production--safety).
12
-
13
8
  ## Why keke?
14
9
 
15
10
  - **Protocol: ACP for every client**
16
11
  Speaks the open Agent Client Protocol for both external client integrations and its internal TUI/agent seam.
12
+ - **Multi-Account & Per-Directory Routing**
13
+ Login to multiple subscription accounts (e.g., work and personal) and automatically route requests based on workspace directory path.
17
14
  - **Script & CI First (`keke exec`)**
18
15
  Supports one-shot execution out of the box for non-interactive scripting and automated CI pipelines.
19
16
  - **Vendor-Isolated Engine**
@@ -61,6 +58,14 @@ keke resume # pick the last conversation back up
61
58
  Provider routes, API keys, local models, gateways, per-directory accounts, and
62
59
  all other settings are documented in [`docs/config.md`](docs/config.md).
63
60
 
61
+ ## Safety
62
+
63
+ - **Sandboxing & approvals** — `approval_policy` and `sandbox_mode` are
64
+ configurable to match how you run it ([`docs/config.md`](docs/config.md)).
65
+ - **Plugin trust** — repository-provided plugins (hooks, MCP servers) never
66
+ execute on `git clone` alone; a person must approve them, keyed to their
67
+ exact contents, not their path. There's no flag to turn that gate off.
68
+
64
69
  ## Status
65
70
 
66
71
  Usable day to day. `keke exec`, the TUI, and the ACP server all run real
@@ -72,36 +77,9 @@ agent can spawn subagents — isolated child sessions given one task that
72
77
  report back a single answer instead of their whole search trace. See
73
78
  [`docs/ROADMAP.md`](docs/ROADMAP.md) for what's next.
74
79
 
75
- ## Production & safety
76
-
77
- Fine for personal use, local/self-hosted models, and CI one-shots today.
78
- Before trusting it with anything you can't afford to break, weigh in:
79
-
80
- - **Sandboxing & approvals** — default `approval_policy` and `sandbox_mode`
81
- are conservative, but you should confirm they match what you're running
82
- ([`docs/config.md`](docs/config.md)).
83
- - **Plugin trust** — repository-provided plugins (hooks, MCP servers) never
84
- execute on `git clone` alone; a person must approve them, keyed to their
85
- exact contents, not their path. There's no flag to turn that gate off.
86
- - **Maturity** — early (v0.1.x), single-maintainer, no formal security audit
87
- or SLA. Remaining roadmap gaps (full end-to-end MCP tool-call verification)
88
- are tracked in [`docs/ROADMAP.md`](docs/ROADMAP.md).
89
-
90
- **Good fit:** you want no vendor lock-in, script/CI-friendly one-shot runs,
91
- local models, or ACP integration into your own editor/client.
92
- **Not yet a fit:** you need turnkey OAuth for every vendor, an established
93
- plugin ecosystem, or vendor support contracts.
94
-
95
- ## Where it comes from
96
-
97
- keke is a fresh implementation informed by OpenAI's **codex**, xAI's
98
- **grok-build**, and **deepseek-harness**. A few pieces are ported and
99
- attributed in-crate; most of the code is original. Design rationale and
100
- CI-enforced invariants: [`docs/architecture.md`](docs/architecture.md),
101
- [`AGENTS.md`](AGENTS.md).
102
-
103
80
  ## License
104
81
 
105
- Apache-2.0. See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE); code ported from
106
- other projects is attributed in the `THIRD_PARTY_NOTICES.md` of the crate that
107
- contains it.
82
+ Apache-2.0. See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE). Design rationale
83
+ and source attribution are documented in
84
+ [`docs/architecture.md`](docs/architecture.md#why-it-is-shaped-this-way) and
85
+ `THIRD_PARTY_NOTICES.md` files in the relevant crates.
package/README.zh-CN.md CHANGED
@@ -5,12 +5,12 @@
5
5
  keke 是一个专为“零厂商锁定”打造的本地终端编码 agent。
6
6
  可直接搭配你已有的付费订阅、标准 API Key 或自托管的本地模型使用。
7
7
 
8
- **当前状态:早期阶段(v0.1.x),已可用于日常开发。** 适合个人日常主力使用、脚本/CI 自动化及小团队试用。目前尚不适合用于强监管或要求不可中断的生产流水线——详见[生产与安全性](#生产与安全性)。
9
-
10
8
  ## 为什么选择 keke?
11
9
 
12
10
  - **协议:为所有客户端提供 ACP 支持**
13
11
  无论是外部客户端集成,还是内部 TUI 与 agent 之间的解耦边界,统一基于开放的 Agent Client Protocol (ACP)。
12
+ - **多账户与按目录路由**
13
+ 登录多个订阅账户(例如工作账户和个人账户),并根据工作区目录路径自动路由请求。
14
14
  - **脚本与 CI 优先(`keke exec`)**
15
15
  开箱即用支持非交互式一次性执行,专为脚本自动化与 CI 流水线设计。
16
16
  - **与厂商隔离的引擎核心**
@@ -24,7 +24,7 @@ keke 是一个专为“零厂商锁定”打造的本地终端编码 agent。
24
24
  curl -fsSL https://raw.githubusercontent.com/milisp/keke-agent/main/scripts/install.sh | sh
25
25
  ```
26
26
 
27
- 该脚本会下载适合你平台的最新预编译二进制文件至 `~/.local/bin`(可通过 `KEKE_INSTALL_DIR` 覆盖)。将远程脚本管道传输到 `sh` 会以你的权限执行——如介意可先检查脚本:`curl -fsSL .../install.sh | less`。
27
+ 该脚本会下载适合你平台的最新预编译二进制文件至 `~/.local/bin`,也可以通过 `KEKE_INSTALL_DIR` 指定安装目录。
28
28
 
29
29
  ### npm 安装
30
30
 
@@ -37,7 +37,7 @@ npm install -g @milisp/keke
37
37
  ## 快速试用(30 秒)
38
38
 
39
39
  ```sh
40
- keke doctor # 在使用前检查哪些 provider/登录配置能正常解析
40
+ keke doctor # 检查 provider 和登录配置
41
41
 
42
42
  # 使用已有付费订阅登录……
43
43
  keke login codex
@@ -52,25 +52,12 @@ keke resume # 恢复上一次的对话
52
52
 
53
53
  配置文件位置、Provider 声明、API Key、本地模型、多账号、按目录切换账号及其他设置,详见 [`docs/config.md`](docs/config.md)。
54
54
 
55
- ## 现状
56
-
57
- 日常开发已完全可用。`keke exec`、TUI 和 ACP 服务器均支持端到端完整运行会话;运行时插件(skills、commands、hooks、MCP servers)遵循 Claude Code 格式安装,仓库自带的插件在你显式批准前会保持非激活状态。在运行中的会话内可通过 `/model` 切换模型(模型与 provider 绑定,避免配置持久化无效组合),并且 agent 支持生成子 agent——分配独立任务的子会话,仅汇总返回最终结果而不会污染完整的搜索 trace。后续规划请参见 [`docs/ROADMAP.md`](docs/ROADMAP.md)。
58
-
59
- ## 生产与安全性
60
-
61
- 目前非常适合个人使用、本地/自托管模型以及 CI 一次性任务。在将其托付给任何不容出错的关键场景前,请评估以下事项:
62
-
63
- - **沙盒与审批** — 默认的 `approval_policy` 和 `sandbox_mode` 策略较为保守,但建议确认其符合你的运行环境与需求([`docs/config.md`](docs/config.md))。
64
- - **插件信任机制** — 仓库自带的插件(hooks、MCP servers)在单纯 `git clone` 后绝不会自动执行;必须由人工确认批准,且该授权基于命令的具体内容而非文件路径。系统未提供任何可全局绕过此门控的开关。
65
- - **成熟度** — 项目处于早期阶段(v0.1.x),目前由单人维护,暂无正式的安全审计或 SLA。路线图中的待补齐项(完整的端到端 MCP 工具调用校验)记录在 [`docs/ROADMAP.md`](docs/ROADMAP.md) 中。
66
-
67
- **适合的场景:** 希望摆脱厂商锁定、需要脚本/CI 友好的一次性运行模式、使用本地模型,或希望将 ACP 集成至自己的编辑器/客户端中。
68
- **暂不适合的场景:** 需要针对所有厂商的即插即用式开箱即用 OAuth、成熟的插件生态市场,或需要商业支持合同。
55
+ ## 功能状态
69
56
 
70
- ## 灵感与来源
57
+ keke 已支持日常开发所需的完整会话。你可以使用 `keke exec` 执行一次性任务,也可以通过 TUI 或 ACP 接入自己的编辑器和客户端。运行时插件(skills、commands、hooks、MCP servers)遵循 Claude Code 格式安装;会话中还可以使用 `/model` 切换模型,并生成独立的子 agent 处理分配的任务。
71
58
 
72
- keke 是一个全新的实现,参考并吸取了 OpenAI 的 **codex**、xAI 的 **grok-build** 以及 **deepseek-harness** 的设计思路。少数模块直接移植并在对应 crate 中注明来源;大部分代码均为原创。设计理念与 CI 强制执行的不变量详见:[`docs/architecture.md`](docs/architecture.md)、[`AGENTS.md`](AGENTS.md)。
59
+ 后续规划请参见 [`docs/ROADMAP.md`](docs/ROADMAP.md)。
73
60
 
74
61
  ## 许可证
75
62
 
76
- Apache-2.0。详见 [`LICENSE`](LICENSE) 与 [`NOTICE`](NOTICE);从其他项目移植的代码在相应 crate 的 `THIRD_PARTY_NOTICES.md` 中注明来源。
63
+ Apache-2.0。详见 [`LICENSE`](LICENSE) 与 [`NOTICE`](NOTICE)。设计背景与代码来源说明见 [`docs/architecture.md`](docs/architecture.md#why-it-is-shaped-this-way) 及相关 crate 中的 `THIRD_PARTY_NOTICES.md`。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@milisp/keke",
3
- "version": "0.1.9",
3
+ "version": "0.1.11",
4
4
  "description": "keke is a multi-vendor terminal coding agent.",
5
5
  "license": "Apache-2.0",
6
6
  "bin": {
@@ -18,11 +18,11 @@
18
18
  "win32"
19
19
  ],
20
20
  "optionalDependencies": {
21
- "@milisp/keke-darwin-x64": "0.1.9",
22
- "@milisp/keke-darwin-arm64": "0.1.9",
23
- "@milisp/keke-linux-x64": "0.1.9",
24
- "@milisp/keke-linux-arm64": "0.1.9",
25
- "@milisp/keke-win32-x64": "0.1.9"
21
+ "@milisp/keke-darwin-x64": "0.1.11",
22
+ "@milisp/keke-darwin-arm64": "0.1.11",
23
+ "@milisp/keke-linux-x64": "0.1.11",
24
+ "@milisp/keke-linux-arm64": "0.1.11",
25
+ "@milisp/keke-win32-x64": "0.1.11"
26
26
  },
27
27
  "repository": {
28
28
  "type": "git",