New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →
Get Started

ligule

Package Overview
Dependencies
Maintainers
1
Versions
8
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

ligule

共享会话与工具内核的命令行和终端 AI 助手。An AI agent harness for the command line and terminal.

latest
Source
npmnpm
Version
0.1.0
Version published
Weekly downloads
0
Maintainers
1
Weekly downloads
 
Created
Source
Ligule

Ligule CLI / TUI

共享 Agent Core 的命令行与交互式终端 AI 助手

English · 项目主页 · npm

npm Node.js

安装与启动

需要 Node.js 24 或更新版本。CLI 和 TUI 使用同一个 npm 包:

npm install -g ligule

在项目目录中执行单次任务:

ligule run "检查项目结构并提出建议"

运行 ligule 打开交互式 TUI,可进行持续对话、查看会话与审批,并选择模型及工具模式。

终端工作方式

  • CLI:适合命令行中的一次性任务与自动化调用。
  • TUI:通过 /model 选择模型,/permission 与 /policy 分别管理 Session 权限和审批规则。
  • Agent Control(外部控制):使用 /control 创建、查看和撤销项目专属 Grant,允许其他 Agent 通过本地 MCP 控制 Ligule;Grant 上限与 Policy 硬拒绝仍然生效。

本地 MCP

以当前受信任项目为目标启动 stdio MCP Server:

ligule mcp-server --project /path/to/project

默认不授予写入权限。已通过 /control 创建授权后,可在 MCP 客户端配置中指定 --grant <id>,需要代答普通审批时再选择 --operator;两者都不会自行赋予超出 Grant 的权限。受限 Shell 在缺少足够 OS Sandbox 时仍会拒绝执行。

配置与链接

CLI/TUI 与 Desktop 共享 Agent Core 的会话及工具语义。模型配置、凭据来源、MCP 配置和权限详见:

MIT

Keywords

agent

FAQs

Package last updated on 24 Oct 2026

Related posts