@milisp/keke 0.1.14 → 0.1.16

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 (3) hide show
  1. package/README.md +24 -30
  2. package/README.zh-CN.md +37 -26
  3. package/package.json +7 -7
package/README.md CHANGED
@@ -2,32 +2,26 @@
2
2
 
3
3
  [中文文档](README.zh-CN.md) | [Architecture](docs/architecture.md) | [Config](docs/config.md) | [Roadmap](docs/ROADMAP.md)
4
4
 
5
- keke is a local terminal coding agent built for zero-vendor lock-in.
6
- Works with subscriptions you already have (ChatGPT, Grok), standard API keys, or self-hosted local models.k
5
+ **keke** is a local terminal coding agent built in Rust for zero vendor lock-in.
6
+ **7 MB download · zero external runtime dependencies · instant startup.**
7
+
8
+ [![asciicast](https://asciinema.org/a/eUqMzR5n59Pfsta5.svg)](https://asciinema.org/a/eUqMzR5n59Pfsta5)
7
9
 
8
10
  ## Why keke?
9
11
 
10
- - **Protocol: ACP for every client**
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., ChatGPT, Grok, work/personal) and automatically route requests based on workspace directory path.
14
- - **Script & CI First (`keke exec`)**
15
- Supports one-shot execution out of the box for non-interactive scripting and automated CI pipelines.
16
- - **Vendor-Isolated Engine**
17
- No vendor-specific logic inside `keke-core`. Adding standard model endpoints requires zero engine code changes — just a quick entry in `config.toml`.
12
+ - **Use what you already pay for**
13
+ Sign in with ChatGPT (Codex) or Grok subscriptions, or drop in any API key. No need to switch providers just to try a different model.
18
14
 
19
- ## Install
15
+ - **Multi-account, per-directory routing**
16
+ Log in to work and personal accounts once. keke automatically picks the right one based on the directory you’re in.
20
17
 
21
- ### Shell (recommended)
18
+ - **Script- and CI-friendly**
19
+ `keke exec "..."` runs one-shot tasks non-interactively — ready for scripts and pipelines.
22
20
 
23
- ```sh
24
- curl -fsSL https://raw.githubusercontent.com/milisp/keke-agent/main/scripts/install.sh | sh
25
- ```
21
+ - **Vendor-isolated core**
22
+ `keke-core` contains zero vendor-specific logic. Point it at any OpenAI-compatible endpoint with a few lines in `config.toml`.
26
23
 
27
- This downloads the latest prebuilt binary for your platform into
28
- `~/.local/bin` (override with `KEKE_INSTALL_DIR`). Piping a remote script into
29
- `sh` runs it with your privileges — inspect it first if that matters to you:
30
- `curl -fsSL .../install.sh | less`.
24
+ ## Install
31
25
 
32
26
  ### npm
33
27
 
@@ -39,6 +33,17 @@ You can also grab a binary directly from the
39
33
  [latest release](https://github.com/milisp/keke-agent/releases/latest), or build
40
34
  from source with `cargo build --release`.
41
35
 
36
+ ### Shell
37
+
38
+ ```sh
39
+ curl -fsSL https://raw.githubusercontent.com/milisp/keke-agent/main/scripts/install.sh | sh
40
+ ```
41
+
42
+ This downloads the latest prebuilt binary for your platform into
43
+ `~/.local/bin` (override with `KEKE_INSTALL_DIR`). Piping a remote script into
44
+ `sh` runs it with your privileges — inspect it first if that matters to you:
45
+ `curl -fsSL .../install.sh | less`.
46
+
42
47
  ## Try it (30 seconds)
43
48
 
44
49
  ```sh
@@ -66,17 +71,6 @@ all other settings are documented in [`docs/config.md`](docs/config.md).
66
71
  execute on `git clone` alone; a person must approve them, keyed to their
67
72
  exact contents, not their path. There's no flag to turn that gate off.
68
73
 
69
- ## Status
70
-
71
- Usable day to day. `keke exec`, the TUI, and the ACP server all run real
72
- sessions end to end; runtime plugins (skills, commands, hooks, MCP servers)
73
- install in the Claude Code format, and repository-provided ones stay inert
74
- until you approve them. `/model` switches models inside a running session
75
- (tied to their provider so config can't persist an invalid pairing), and the
76
- agent can spawn subagents — isolated child sessions given one task that
77
- report back a single answer instead of their whole search trace. See
78
- [`docs/ROADMAP.md`](docs/ROADMAP.md) for what's next.
79
-
80
74
  ## License
81
75
 
82
76
  Apache-2.0. See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE). Design rationale
package/README.zh-CN.md CHANGED
@@ -2,62 +2,73 @@
2
2
 
3
3
  [English](README.md) | [架构设计](docs/architecture.md) | [配置文档](docs/config.md) | [路线图](docs/ROADMAP.md)
4
4
 
5
- keke 是一个专为“零厂商锁定”打造的本地终端编码 agent。
6
- 可直接搭配你已有的付费订阅、标准 API Key 或自托管的本地模型使用。
5
+ **keke** 是用 Rust 编写的本地终端编码 agent,目标是零厂商锁定。
6
+ **下载约 7 MB · 无外部运行时依赖 · 即开即用。**
7
+
8
+ [![asciicast](https://asciinema.org/a/eUqMzR5n59Pfsta5.svg)](https://asciinema.org/a/eUqMzR5n59Pfsta5)
7
9
 
8
10
  ## 为什么选择 keke?
9
11
 
10
- - **协议:为所有客户端提供 ACP 支持**
11
- 无论是外部客户端集成,还是内部 TUI 与 agent 之间的解耦边界,统一基于开放的 Agent Client Protocol (ACP)。
12
- - **多账户与按目录路由**
13
- 登录多个订阅账户(例如工作账户和个人账户),并根据工作区目录路径自动路由请求。
14
- - **脚本与 CI 优先(`keke exec`)**
15
- 开箱即用支持非交互式一次性执行,专为脚本自动化与 CI 流水线设计。
16
- - **与厂商隔离的引擎核心**
17
- `keke-core` 内部没有任何厂商特定的逻辑。添加标准模型端点无需修改任何引擎代码——只需在 `config.toml` 中简单声明配置即可。
12
+ - **用你已经在付的账**
13
+ 用 ChatGPT(Codex)或 Grok 订阅登录,或直接填入任意 API Key。不必为了试另一个模型而换供应商。
14
+
15
+ - **多账户、按目录路由**
16
+ 工作和私人账户各登录一次。keke 会根据当前目录自动选用对应账户。
17
+
18
+ - **适合脚本和 CI**
19
+ `keke exec "..."` 以非交互方式跑一次性任务,可直接放进脚本和流水线。
20
+
21
+ - **与厂商隔离的核心**
22
+ `keke-core` 不含任何厂商特定逻辑。在 `config.toml` 里写几行,即可指向任意 OpenAI 兼容端点。
18
23
 
19
24
  ## 安装
20
25
 
21
- ### 脚本安装(推荐)
26
+ ### npm
22
27
 
23
28
  ```sh
24
- curl -fsSL https://raw.githubusercontent.com/milisp/keke-agent/main/scripts/install.sh | sh
29
+ npm install -g @milisp/keke
25
30
  ```
26
31
 
27
- 该脚本会下载适合你平台的最新预编译二进制文件至 `~/.local/bin`,也可以通过 `KEKE_INSTALL_DIR` 指定安装目录。
32
+ 也可以从
33
+ [最新 Release](https://github.com/milisp/keke-agent/releases/latest) 直接下载二进制,
34
+ 或用 `cargo build --release` 从源码构建。
28
35
 
29
- ### npm 安装
36
+ ### Shell
30
37
 
31
38
  ```sh
32
- npm install -g @milisp/keke
39
+ curl -fsSL https://raw.githubusercontent.com/milisp/keke-agent/main/scripts/install.sh | sh
33
40
  ```
34
41
 
35
- 你也可以直接从 [最新 Release](https://github.com/milisp/keke-agent/releases/latest) 下载二进制文件,或使用 `cargo build --release` 从源码构建。
42
+ 脚本会把适合当前平台的最新预编译二进制下载到
43
+ `~/.local/bin`(可用 `KEKE_INSTALL_DIR` 覆盖)。把远程脚本管道进
44
+ `sh` 会以你的权限执行——若在意这一点,先检查内容:
45
+ `curl -fsSL .../install.sh | less`。
36
46
 
37
47
  ## 快速试用(30 秒)
38
48
 
39
49
  ```sh
40
- keke doctor # 检查 provider 和登录配置
50
+ keke doctor # 先看清哪些 provider / 登录能解析,再依赖其中之一
41
51
 
42
- # 使用已有付费订阅登录……
52
+ # 用已有付费订阅登录……
43
53
  keke login codex
44
54
  keke login grok
45
- # ……或直接配置 API Key
55
+ # ……或直接提供 Key
46
56
  export ANTHROPIC_API_KEY=sk-ant-...
47
57
 
48
58
  keke exec "what does this project do?" # 一次性运行,适合脚本与 CI
49
59
  keke # 交互式 TUI
50
- keke resume # 恢复上一次的对话
60
+ keke resume # 接上一次对话
51
61
  ```
52
62
 
53
- 配置文件位置、Provider 声明、API Key、本地模型、多账号、按目录切换账号及其他设置,详见 [`docs/config.md`](docs/config.md)。
54
-
55
- ## 功能状态
63
+ Provider 路由、API Key、本地模型、网关、按目录账户及其他设置,见 [`docs/config.md`](docs/config.md)。
56
64
 
57
- keke 已支持日常开发所需的完整会话。你可以使用 `keke exec` 执行一次性任务,也可以通过 TUI 或 ACP 接入自己的编辑器和客户端。运行时插件(skills、commands、hooks、MCP servers)遵循 Claude Code 格式安装;会话中还可以使用 `/model` 切换模型,并生成独立的子 agent 处理分配的任务。
65
+ ## 安全
58
66
 
59
- 后续规划请参见 [`docs/ROADMAP.md`](docs/ROADMAP.md)。
67
+ - **沙箱与审批** — `approval_policy` 和 `sandbox_mode` 可按使用方式配置([`docs/config.md`](docs/config.md))。
68
+ - **插件信任** — 仓库自带的插件(hooks、MCP servers)不会仅因 `git clone` 就执行;必须由人按**内容**(而非路径)批准。没有关闭该门禁的开关。
60
69
 
61
70
  ## 许可证
62
71
 
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`。
72
+ Apache-2.0。见 [`LICENSE`](LICENSE) 与 [`NOTICE`](NOTICE)。设计理由与源码归属见
73
+ [`docs/architecture.md`](docs/architecture.md#why-it-is-shaped-this-way)
74
+ 以及相关 crate 中的 `THIRD_PARTY_NOTICES.md`。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@milisp/keke",
3
- "version": "0.1.14",
3
+ "version": "0.1.16",
4
4
  "description": "keke is a multi-vendor terminal coding agent.",
5
5
  "license": "Apache-2.0",
6
6
  "bin": {
@@ -18,12 +18,12 @@
18
18
  "win32"
19
19
  ],
20
20
  "optionalDependencies": {
21
- "@milisp/keke-darwin-x64": "0.1.14",
22
- "@milisp/keke-darwin-arm64": "0.1.14",
23
- "@milisp/keke-linux-x64": "0.1.14",
24
- "@milisp/keke-linux-arm64": "0.1.14",
25
- "@milisp/keke-win32-x64": "0.1.14",
26
- "@milisp/keke-win32-arm64": "0.1.14"
21
+ "@milisp/keke-darwin-x64": "0.1.16",
22
+ "@milisp/keke-darwin-arm64": "0.1.16",
23
+ "@milisp/keke-linux-x64": "0.1.16",
24
+ "@milisp/keke-linux-arm64": "0.1.16",
25
+ "@milisp/keke-win32-x64": "0.1.16",
26
+ "@milisp/keke-win32-arm64": "0.1.16"
27
27
  },
28
28
  "repository": {
29
29
  "type": "git",