@gajae-code/coding-agent

中文文档
0.21.0发布于 2026/11/16MITTypeScriptES Module构建来源已验证近 30 天下载 7479

Gajae 代码 CLI 有读取、击打、编辑、写作工具和会话管理

中文使用文档
文档目录6 节
  1. 外部生命周期通知
  2. Windows psmux 权威边界
  3. 内存后端
  4. 突然开始
  5. 紅爪 TUI主题
  6. 欢迎 Windows 终端上的横幅字体

@gajae-code/编码代理

执行《公约》的核心一揽子措施 gjc 编码代理 gajae-code 单相机.

关于安装,设置,提供者配置,模型角色,斜线命令,以及完整的CLI参考,参见:

特定软件包参考文献:

外部生命周期通知

GJC已经通过扩展/hook事件合同曝光了公共生命周期事件. Discord, Hermes, 爪子或类似频道的外部通知集成, 应当选择并订阅这些事件, 而不是刮取记录或日志 :

  • turn_end 模型/工具转接完成。 公共载荷是 { type: "turn_end", turnIndex, message, toolResults }。 。 。 .
  • agent_end ——提交快报的代理回路已到达终端边界. 公共载荷是 { type: "agent_end", messages }。 。 。 .

对于不需要完整扩展的简单局部副作用,设置用户级别 completion.notifyCommandGJC运行在完成的代理转盘上 GJC_NOTIFICATION_* 环境变量(GJC_NOTIFICATION_TITLE, (中文(简体) ), GJC_NOTIFICATION_BODY, (中文(简体) ), GJC_NOTIFICATION_JSON等);项目设置无法激活此命令钩.

gjc config set completion.notifyCommand 'cmux notify --title "$GJC_NOTIFICATION_TITLE" --body "$GJC_NOTIFICATION_BODY"'

在macOS上,GJC发布终端BEL完成,批准,并默认在何时通知 notifications.terminalBell 未配置 。 准备吧 false 使macOS终端保持安静.

当GJC运行在 cmux 终端内部时(CMUX_WORKSPACE_ID 设置中),GJC最优工作区重命名为当前GJC会话名称(带有 GJC: 前缀)——但只有在工作空间仍然拥有其默认标题时,所以你所绑定的名称(或由同行会话设定的共享工作空间)永远不会被覆盖. 选择退出 GJC_NO_CMUX_RENAME=1。 。 。 .

Windows 终端可能保存 BEL([Console]::Write([char]7)) 沉默,这取决于配置和系统声音设置,即使在 notifications.terminalBell 已启用。 对于一个可调取的 Windows 完成 哔声, 请配置一个用户级的 PowerShell 命令钩:

gjc config set completion.notifyCommand 'powershell.exe -NoProfile -Command "[Console]::Beep(880, 300)"'

cmux notify 返回成功意味着GJC将完成事件交给了cmux. cmux在app/window被聚焦,放出工作空间活动,或通知面板打开时,仍可能压制本地桌面横幅. 在这种情况下,检查cmux的通知面板或未读的工作空间状态,而不是将缺失的横幅作为GJC送出失败处理. 建议的外部映射 :

通知公共活动现状指南
旋转完成turn_end使用处理器自身的消毒状态, 如 "finished"。 。 。 .
停止/完成代理agent_end将您视为提示的终端 .
等待/封锁/失效agent_end 外加呼叫器的安全摘要目前的生命周期事件没有暴露出单独的结构化等待/封锁的理由;只检查公共安全、一体化的国家.

仅转发一个最小的, 呼叫器-安全有效载荷。 不包括原始提示、 助理记录、 隐藏提示、 工具输出、 原始日志、 主机路径、 私密配置、 Webhook URL、 频道 ID、 符号或秘密 。 安全通知有效载荷应通过扩展/安装本身建造,例如:

import type { ExtensionAPI } from "@gajae-code/coding-agent";

type PublicLifecycleNotification = {
    type: "turn_end" | "agent_end";
    status: "finished" | "stopped" | "failed" | "blocked" | "waiting";
    turnIndex?: number;
    timestamp: string;
    summary: string;
};

export default function lifecycleNotifier(pi: ExtensionAPI) {
    const enabled = process.env.GJC_LIFECYCLE_NOTIFY === "1";
    if (!enabled) return;

    const send = async (payload: PublicLifecycleNotification) => {
        // POST to Discord/Hermes/clawhip here. Keep target URLs and channel IDs in
        // private config or environment variables; never include them in payloads.
    };

    pi.on("turn_end", event =>
        send({
            type: "turn_end",
            status: "finished",
            turnIndex: event.turnIndex,
            timestamp: new Date().toISOString(),
            summary: "GJC turn finished",
        }),
    );

    pi.on("agent_end", () =>
        send({
            type: "agent_end",
            status: "stopped",
            timestamp: new Date().toISOString(),
            summary: "GJC prompt reached a terminal lifecycle boundary",
        }),
    );
}

这是支持的再生生命周期通知路径. 这不是 Claude 代码钩钩兼容性, 除非用户配置扩展/ hook 处理器和私人发送目标, 否则它仍然被禁用 .

Windows psmux 权威边界

在本地 Windows 上, GJC 管理的 psmux 会话持续为每个所有者 ProviderAuthority: 准确解析的可执行身份和一个孤立的 tmux 兼容 -L 名称空间. GJC_TMUX_COMMAND 仅是一个可执行路径/ 名称, 绝不 psmux -L …。通过GJC恢复管理会话,以便重新使用和重新证明这一权限;不要回到环境 tmux编号 :psmux 或手动重建命名空间。 无法使用、改变或含糊不清的权威未能关闭.

内存后端

该代理支持三个相互排斥的内存后端,通过 memory.backend 设置( 设置 内存标签, 或 ~/.gjc/agent/config.yml:

  • off (默认)——没有内存子系统运行.
  • local - 现有的推出-总结管道 memory_summary.md 和综合文物 代理目录.
  • hindsight - 与一个 后视 服务器。 Hindsight使用私人后端生命周期钩来保留记录和召回上下文;对于遗留后端的调用,仅兼容的内部仍然保留,但GJC不暴露公共编码-harness内存工具等 retain, (中文(简体) ), recall,或 reflect。 。 。 .

突然开始

  1. 运行 Hindsight 服务器( 云或) docker run -p 8888:8888 ghcr.io/vectorize-io/hindsight:latest) (中文(简体) ).
  2. 设定 memory.backend = "hindsight" 财务报告和审定财务报表 hindsight.apiUrl = "http://localhost:8888" (或你的云URL).
  3. 可选环境覆盖( env 胜过设置) :
    • HINDSIGHT_API_URL, (中文(简体) ), HINDSIGHT_API_TOKEN - 连接
    • HINDSIGHT_BANK_ID, (中文(简体) ), HINDSIGHT_DYNAMIC_BANK_ID, (中文(简体) ), HINDSIGHT_AGENT_NAME 银行地址
    • HINDSIGHT_AUTO_RECALL, (中文(简体) ), HINDSIGHT_AUTO_RETAIN, (中文(简体) ), HINDSIGHT_RETAIN_MODE - 生命周期
    • HINDSIGHT_RECALL_BUDGET, (中文(简体) ), HINDSIGHT_RECALL_MAX_TOKENS ——回顾尺寸
    • HINDSIGHT_BANK_MISSION, (中文(简体) ), HINDSIGHT_DEBUG

在下一次系统即时重建及下一次重建中, 将切换后端 /memory 斜线命令。 现有用户 memories.enabled = true|false 迁移到 memory.backend = "local"|"off" 刚刚发射一次.

紅爪 TUI主题

交互式 TUI 默认为捆绑 red-claw 暗终端和捆绑的甲壳类主题 blue-crab 主题为光出现终端,并配对欢迎/icon资产。 增加三个捆绑的移徙主题—— claude-code, (中文(简体) ), codex,以及 opencode - 反映这些工具的外观,便于眼动,可从设置中选择 /theme。明确的用户主题设置仍然赢得;设置 theme.dark: red-claw 财务报告和审定财务报表 theme.light: blue-crab 内 ~/.gjc/agent/config.yml 把他们钉上.

欢迎 Windows 终端上的横幅字体

启动标志默认为圆形 Unicode 框绘图 。 Windows终端可以在所选配置字体具有需要的框画格时正确渲染;推荐的选择是 Cascadia Mono 或者说 Cascadia Mono Nerd Font。在 Windows 终端设置中,将配置字体面值设置为其中之一,或添加到配置 JSON 中:

"font": {
  "face": "Cascadia Mono"
}

对于断开圆角的终端或字体,设置 startup.welcomeBannerMode 内 ~/.gjc/agent/config.yml 对其中之一 unicode, (中文(简体) ), square,或 ascii。 。 。 . square 保留使用平角的Unicode外观标志(┌ ┐ └ ┘时 ascii 仅使用 +, (中文(简体) ), -,以及 |。 。 。 .

版本与发布记录

@gajae-code/coding-agent 共发布 157 个版本,首次发布于 2026/05/28;过去 12 个月发布了 157 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.21.0latest2026/11/16今天
0.20.1-nightly.20261108030927.43711868338.gb4127889c4a8nightly2026/11/15今天
0.20.1-nightly.20261108030927.43590872198.gb4127889c4a82026/11/141 天前
0.20.1-nightly.20261108030927.43424588966.gb4127889c4a82026/11/132 天前
0.20.1-nightly.20261108030927.43222623203.gb4127889c4a82026/11/123 天前
0.20.1-nightly.20261108030927.43016219422.gb4127889c4a82026/11/114 天前

关于 @gajae-code/coding-agent 的常见问题

@gajae-code/coding-agent 是什么?

Gajae 代码 CLI 有读取、击打、编辑、写作工具和会话管理

如何安装 @gajae-code/coding-agent?

在项目目录运行 npm install @gajae-code/coding-agent,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gjc,可以用 npx gjc 直接运行。

@gajae-code/coding-agent 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gajae-code/coding-agent 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gajae-code/coding-agent 可以商用吗?

@gajae-code/coding-agent 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gajae-code/coding-agent 的下载量有多少?

根据 npm 官方下载统计,@gajae-code/coding-agent 在 2026/10/16 – 2026/11/14 这 30 天内被下载 7,479 次,日均约 249 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gajae-code/coding-agent 还在维护吗?

最新版本 0.21.0 发布于 2026/11/16(今天);至今共发布 157 个版本,其中过去 12 个月发布了 157 个;首次发布于 2026/05/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。