customize-agent

Customize Agent

通用终端 AI 助手，支持 CUSTOMIZE.md 角色定制、原生 Function Calling、双语 TUI、三级模型分层、本地知识库和 Web 管理控制台。

当前仓库是 pnpm monorepo：8 个核心 packages + 2 个 apps（CLI 与 Next.js Web 控制台）。

快速安装

npm 用户

npm install -g customize-agent
customize

安装后会暴露两个等价命令：

customize
customize-agent

CLI 启动时会自动拉起 Web 控制台，默认地址为：

http://127.0.0.1:17321/overview

如端口被占用，CLI 会自动尝试后续端口；也可以通过 CUSTOMIZEDASHBOARDPORT 指定固定端口。

源码开发

git clone https://github.com/Pan-jijian/customize-agent.git
cd customize-agent
pnpm install
pnpm run build
pnpm start:cli

常用开发命令：

pnpm run build
pnpm run typecheck
pnpm run lint
pnpm test
pnpm --filter @customize-agent/server dev

环境要求

• Node.js：建议使用 22+；CI 当前覆盖 Node 24。
• pnpm：仓库使用 pnpm@10.26.1。
• 平台：macOS、Windows、Linux。
• 可选：Docker，用于容器沙箱。

首次配置