共享会话与工具内核的命令行、终端和桌面 AI 助手。An AI agent harness with shared sessions and tools across CLI, terminal, and desktop interfaces.
ligule 是一个为项目工作、共享同一套 Agent 内核的 AI 助手，提供三种入口。三种入口共用工具执行、审批、模型请求和会话记录。
| 入口 | 适合场景 | 启动方式 |
|---|---|---|
| CLI | 脚本、管道和单次任务 | ligule run "检查项目结构并提出建议" |
| TUI | 在终端持续对话与管理会话 | ligule |
| Desktop | 使用工作区侧栏、图形设置和会话操作 | 安装对应平台的桌面包后启动 |
CLI 与 TUI 需要 Node.js 24 或更新版本。TUI 需要交互式终端；脚本和管道使用 ligule run。桌面包的平台范围和维护者发行流程见发行说明。
首次使用前，请先配置模型服务，配置位置见下方「配置与数据」。
安装 CLI 和 TUI：
npm install -g ligule
cd /path/to/your-project
ligule run "检查项目结构并提出建议"
cd /path/to/your-project
ligule
在 GitHub Releases下载。桌面版首次启动会准备默认工作区；也可以在设置中更改新会话使用的默认目录。
默认从 ~/.ligule/config.toml 读取模型服务设置。最小配置示例：
[model]
api = "chat-completions"
baseURL = "https://api.example.com/v1"
model = "model-name"
apiKeyEnv = "MODEL_API_KEY"
把密钥放入 apiKeyEnv 指定的环境变量。桌面设置还支持多个服务与模型，并可将密钥保存到系统凭据库。设置 LIGULE_HOME 可将用户数据根改为另一绝对路径。工作区目录决定项目归属，boundary 单独限制文件工具可以访问的范围。
开发本仓库需 Node.js 24 或更新版本和 pnpm 12.9.1。在仓库根目录运行 pnpm install --frozen-lockfile 安装开发依赖。其余构建和检查步骤见贡献与验证。
FAQs
共享会话与工具内核的命令行和终端 AI 助手。An AI agent harness for the command line and terminal.
The npm package ligule receives a total of 710 weekly downloads. As such, ligule popularity was classified as not popular.
We found that ligule demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
Malicious Firefox extensions mimic Phantom, Jupiter, and Bitget wallets to steal recovery phrases and private keys, with one fetching its payload remotely.
Product
Socket Threat Intel now shows which malware campaigns were blocked or detected in your organization, with links to scans and Firewall events.
Security News
Fixes for eMudhra and Brotli are out. Getting them everywhere they’re needed means tracking down bundled libraries, runtimes, and certificate stores.