Skip to content
项目

vincemakes/kiso has 96 GitHub stars and 10 forks. GitHot measured 0 stars in 24 hours, +8 in 7 days, and +13 in 15 days. Last checked 2026-11-15 16:28 UTC. Last push 2026-11-15.

这些数字如何统计

实测星标增长

24小时
0
7天
+8
15天
+13
1个月
更新延迟

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

The durable runtime for AI agents: event-sourced sessions, approvals that persist across processes, exact resume after a crash. A 2,200-line TypeScript kernel, and kiso-code, the coding agent built on it.

人工智能

README.zh.md

原文

kiso

kiso 是一个持久的 agent 运行时,内核上限 2,200 行;
它之上还有一个跑在终端里的编程助手。

npm CI MIT license

v0.53.0 · Node ≥ 22 · kiso.work · English

内置,不是外挂:先问清再动手;子代理并行;后台任务;审批模式;崩溃后接着做;随你扩展。

深色终端里的 kiso:一段绿色的新增测试 diff,随后测试套件作为后台任务启动,状态行显示“1 task running”

安装

npm install -g @vincemakes/kiso-code
kiso

需要 Node ≥ 22,支持 macOS 和 Linux。不想安装可以直接 npx @vincemakes/kiso-code。第一次运行不需要密钥:kiso 会先用内置脚本演示一轮完整流程,不花一分钱,然后提示你接入模型。

kiso login deepseek      # 也可以是 anthropic / openai / zai
kiso login chatgpt       # ChatGPT 订阅:浏览器登录,不需要密钥
kiso login --endpoint https://gateway.example/v1   # 网关:密钥只发给这个网关

密钥从不写进配置文件。模型档、思考档位、上下文窗口等全部选项见 docs/configuration.md。

kiso web

同一个助手,在这台机器的浏览器里:一个本地网页应用,显示每次运行的过程、旁边是它改的文件和产出,以及所有文件夹的工作历史。它是单独的包,和终端版并列安装:

npm install -g @vincemakes/kiso-web
kiso web

kiso web 启动宿主并打开 http://127.0.0.1:4317 上的页面(--port <n> 换端口,--no-open 只打印地址)。页面要能用,宿主必须在运行: 命令运行多久宿主就运行多久,命令停了页面就打不开。模型、推理强度和登录都沿用终端版的(~/.kiso/config.json、kiso login)。没装这个包时,kiso web 会打印安装命令。

想放在桌面上:先打开一次页面,再把它添加为应用。Safari(macOS Sonoma 及以上):文件 > 添加到程序坞;Chrome 或 Edge(macOS 或 Linux):将此页面作为应用安装。端口是固定的,所以应用地址不会变;打开它之前先运行 kiso web。kiso web 支持 macOS 和 Linux;暂不支持 Windows。

登录只在本机进行:命令用一次性代码打开页面,页面用它换取会话 cookie。已登录的会话就是这台机器 shell 的钥匙:拿到它的人可以用你的身份执行命令。宿主只监听 127.0.0.1。kiso web --revoke-sessions 让所有页面退出登录,之后每个页面都要再从命令登录一次。

它怎么做到的

  • 断了能接着做。 进程崩溃、kill -9、关掉终端之后,kiso resume 从已提交的持久前缀继续:中断时还没生成完的内容会重新生成,结果不确定的操作交给人决定,绝不自动重做。
  • 长任务不爆上下文。 用到窗口一半时,kiso 在一个阶段结束后自动压缩,新摘要替换旧摘要,不会越压越多。
  • 哪家的模型都能接。 DeepSeek、Claude、GPT、ChatGPT 订阅,以及任何 OpenAI 兼容的端点和网关。
  • 花在哪里一目了然。 每轮结束显示这一轮的新输入、输出和缓存命中;/context 看上下文被什么占着。
  • 小而透明。 内核上限 2,200 行(现在 2,194 行);会话就是一份可以直接读的 JSONL 日志;每个设计决定都记在 46 份 ADR 里,写明为什么这样做、什么情况下该推翻它。

按键、命令和状态栏的完整说明见 docs/cli.md。会话里按 ? 看按键,/help 看命令。ctrl+v 贴剪贴板里的图片(仅 macOS;其他系统请在消息里写上图片的路径)。

审批模式

/mode 或 shift+tab 切换,状态栏始终显示当前模式。

模式 行为
default 读文件和只读命令直接放行;写文件、改文件、其他命令先问你
accept-edits 在 default 基础上,改文件也直接放行(.git/、.kiso/ 除外)
plan 只能读,其他一律拒绝
full-access 全部放行,不再询问;你的拒绝规则和底线照样生效

模式只是 deny > allow > ask 这条链里的一票:保存过的“不再询问”规则在任何模式下都照样放行,切换模式不会撤销它。这些规则存在 ~/.kiso/extensions/dont-ask-again.mjs,删掉一条就会重新询问。无论哪种模式,包括 full-access,指向删了就无法恢复的位置的破坏性命令都会被拒绝:/、你的家目录、工作区根目录、它的 .git、~/.ssh 这类。完整规则见 docs/cli.md。

扩展

扩展就是一个普通的 .mjs 文件,不需要构建。内置了五个:MCP、技能、子代理、提问和任务清单。写自己的扩展见 docs/extensions.md。

哪些子进程会被剥离凭据。 模型能触发运行的两类:shell 工具,以及用 stdio 启动的 MCP 服务器。它们拿不到模型商的凭据:已知的密钥变量、以 _API_KEY 或 _AUTH_TOKEN 结尾的变量、以及模型档 apiKeyEnv 指定的变量都会被去掉。不剥离的:subagent 的子进程(它就是 kiso 本身,要连模型),以及你自己启动的程序($EDITOR、登录用的浏览器、kiso update),它们照常继承你的环境。

使用方式

这个助手建在 @vincemakes/kiso-runtime 之上:一个持久的、只追加的会话存储,一个 agent 工厂,和一条带类型的事件流。

import { defineTool } from "@vincemakes/kiso-core";
import { createAgent, SessionStore } from "@vincemakes/kiso-runtime";
import { createAnthropicAdapter } from "@vincemakes/kiso-provider-anthropic";
import Anthropic from "@anthropic-ai/sdk";

const agent = createAgent({
  model: "claude-sonnet-5",
  tools: [
    defineTool({
      name: "add",
      description: "Add two numbers",
      parameters: { type: "object", properties: { a: { type: "number" }, b: { type: "number" } }, required: ["a", "b"], additionalProperties: false },
      execute: async ({ a, b }) => ({ content: String(a + b), isError: false }),
    }),
  ],
  store: new SessionStore("./sessions"),          // append-only JSONL
  adapter: createAnthropicAdapter(new Anthropic()),
});

const session = await agent.session({ id: "demo" });
for await (const ev of session.run("What is 2+3?")) {
  switch (ev.type) {
    case "text_delta": process.stdout.write(ev.text); break;
    case "terminal": console.log("\n", ev.outcome.kind); break;
  }
}

SDK 入门见 docs/getting-started.md。

文档

上手 cli-quickstart.md · getting-started.md
参考 cli.md · configuration.md · extensions.md · sdk.md
设计 durability.md · context.md · architecture.md · kernel-rule.md · ADR
现状 status.md · bench/README.md

许可

MIT