Skip to content

LegnaOS/LegnaCode-cli

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
npm
npm
 
 
scripts
scripts
 
 
src
src
 
 
stubs
stubs
 
 
webui
webui
 
 
.gitignore
.gitignore
 
 
CHANGELOG.md
CHANGELOG.md
 
 
COMPARISON.md
COMPARISON.md
 
 
README.md
README.md
 
 
bun.lock
bun.lock
 
 
bunfig.toml
bunfig.toml
 
 
package.json
package.json
 
 
tsconfig.json
tsconfig.json
 
 

Repository files navigation

LegnaCode CLI

image image

LegnaCode 是一个基于 Anthropic Claude 的智能终端编程助手，让你直接在命令行中与 AI 协作完成软件工程任务——编辑文件、执行命令、搜索代码、管理 Git 工作流等。

📊 与 Claude Code 原版的详细对比 → COMPARISON.md

更新日志

详见 CHANGELOG.md

版本 日期 摘要
1.4.4 2026-04-11 状态提示改为 spinner 行显示（不污染对话），新增功能对比文档
1.4.3 2026-04-11 mempalace 记忆架构融合（DrawerStore + TF-IDF 向量搜索 + 4 层记忆栈 + 时序知识图谱），token 节省 ~88%
1.4.2 2026-04-11 进度反馈增强（消除 8 个静默代码路径），verbose 默认开启，Token/Timer 即时显示，中断原因可见
1.4.0 2026-04-11 MiniMax 深度原生兼容（6 个多模态工具），RPC 子进程工具执行，Memory Provider 插件系统，智能模型路由，自主技能检测，上下文压缩增强，跨会话记忆搜索
1.3.7 2026-04-09 Resume 会话检测修复，Interrupted 诊断日志，后台任务状态可见性增强
1.3.6 2026-04-09 修复 Windows 路径分隔符导致 Edit 工具 "File has been unexpectedly modified" 误报
1.3.5 2026-04-07 修复 SessionStart hook 报错，Windows alt-screen 渲染深度修复（消除 fullReset 闪烁）
1.3.4 2026-04-07 OML Superpowers 工程纪律（/verify /tdd /debug /brainstorm 等 11 个 skill），SessionStart 技能引导
1.3.3 2026-04-07 OML 智能编排层内置（magic keywords + 19 agent skills），Windows Terminal fullscreen 修复
1.3.2 2026-04-07 禁用 History Snip，修复 Windows Terminal 流式文本渲染
1.3.1 2026-04-06 修复 1M 模型被过早 snip 的问题，snip 阈值感知 context window 大小
1.3.0 2026-04-04 项目本地化存储：会话/skills/memory/rules 下沉到 <project>/.legna/，全局迁移 ~/.claude/ → ~/.legna/，legna migrate 命令
1.2.1 2026-04-04 模型适配器层：MiMo、GLM、DeepSeek、Kimi、MiniMax 五大提供商深度兼容
1.2.0 2026-04-03 会话按项目分组、resume 带 cd、迁移支持会话记录、Windows 原生编译
1.1.9 2026-04-03 postinstall 自动安装平台包，修复 Windows/镜像源 optionalDependencies 失效
1.1.8 2026-04-03 bin wrapper 自动安装缺失平台包，修复 Windows npm 全局安装问题
1.1.7 2026-04-03 彻底修复 Windows external module 报错，清空 external 列表
1.1.6 2026-04-03 修复 Windows external module 报错、全平台发版流程自动化、版本号统一
1.1.5 2026-04-03 WebUI 管理面板 (legna admin)、双目录管理、配置迁移、npm 全平台发布
1.0.9 2026-04-03 i18n 多语言补全、内置精美状态栏、配置自动迁移
1.0.8 2026-04-02 MONITOR_TOOL、WORKFLOW_SCRIPTS、HISTORY_SNIP，3 个重量级子系统，累计 47 flags
1.0.7 2026-04-02 TERMINAL_PANEL、WEB_BROWSER_TOOL、TEMPLATES、BG_SESSIONS，累计 44 flags
1.0.6 2026-04-02 CACHED_MICROCOMPACT、AGENT_TRIGGERS、TREE_SITTER_BASH 等 7 个功能，累计 40 flags
1.0.5 2026-04-02 AGENT_TRIGGERS、MCP_SKILLS、REACTIVE_COMPACT、REVIEW_ARTIFACT 等 6 个功能，累计 39 flags
1.0.4 2026-04-02 ULTRAPLAN、VERIFICATION_AGENT、AUTO_THEME 等 10 个功能，累计 33 flags
1.0.3 2026-04-02 COMMIT_ATTRIBUTION、BASH_CLASSIFIER、EXTRACT_MEMORIES 等 16 个功能
1.0.2 2026-04-02 QUICK_SEARCH、MESSAGE_ACTIONS、FORK_SUBAGENT、HISTORY_PICKER
1.0.1 2026-04-02 BUDDY 虚拟宠物、TOKEN_BUDGET、构建系统修复
1.0.0 2026-03-31 初始发布

致谢

本项目基于 Claude Code CLI 的公开源码构建。

Claude Code 是 Anthropic 团队打造的一款出色的终端 AI 编程工具，它开创性地将大语言模型与命令行开发工作流深度融合，提供了文件编辑、代码搜索、Shell 执行、MCP 协议等丰富能力。LegnaCode 站在这个优秀项目的肩膀上，进行了定制化改造和品牌适配。

感谢 Anthropic 团队将 Claude Code CLI 开源，让社区能够在此基础上探索更多可能性。

特性

  • MiniMax 深度原生兼容 — 使用 MiniMax 模型时自动注册 6 个多模态工具（图像/视频/语音/音乐/搜索/视觉），/auth-minimax 配置 API key
  • 终端原生体验 — 基于 React + Ink 构建的现代终端 UI，支持语法高亮、结构化 Diff 展示
  • 45+ 内置工具 — 文件读写、代码搜索（Glob/Grep）、Shell 执行、Web 抓取、Jupyter Notebook 编辑等
  • RPC 子进程工具执行 — AI 生成的脚本通过 Unix Domain Socket 回调 LegnaCode 工具，多步操作压缩为一次推理
  • Memory Provider 插件系统 — 可插拔的记忆后端，内置文件系统 provider，支持外部 provider 扩展
  • 智能模型路由 — 基于 prompt 复杂度自动路由到 fast/default/strong 模型层
  • 自主技能检测 — 检测重复工具调用模式，提示保存为可复用技能
  • 上下文压缩增强 — 工具输出预剪枝 + 预算压力注入，长对话更高效
  • 跨会话记忆搜索 — /recall 命令搜索历史会话，关键词匹配 + 相关性排序
  • 多层安全防护 — Bash/Zsh/PowerShell 命令安全检测、沙箱机制、权限分级控制
  • 多云 AI 后端 — 支持 Anthropic API、AWS Bedrock、GCP Vertex、Azure
  • MCP 协议支持 — 通过 Model Context Protocol 连接外部工具和数据源
  • 多 Agent 协作 — 支持子 Agent 派生、团队协作、任务编排
  • 插件与技能系统 — 可扩展的插件架构和可复用的技能工作流
  • 持久化记忆 — 跨会话的上下文记忆系统
  • 纯 TS 语法高亮 — 内置基于 highlight.js 的纯 TypeScript 语法高亮实现，无需原生模块依赖
  • WebUI 管理面板 — legna admin 启动浏览器管理面板，可视化编辑配置、切换配置文件、浏览会话记录、迁移数据
  • legna migrate 命令 — 手动迁移 ~/.claude/ 数据到项目本地 .legna/，支持 --global/--sessions/--dry-run

环境要求

依赖 版本
Bun >= 1.2.0
Node.js >= 18（可选）
Git >= 2.0
操作系统 macOS / Linux

安装

方式一：npm 全局安装（推荐）

npm install -g @legna-lnc/legnacode

如果使用镜像源（如 cnpm、淘宝源）安装失败或版本未同步，可指定官方源安装：

npm install -g @legna-lnc/legnacode --registry=https://registry.npmjs.org

安装后即可在任意目录使用 legna 命令。会自动下载当前平台的预编译二进制（支持 macOS arm64/x64、Linux x64/arm64、Windows x64）。

# 验证安装
legna --version

# 更新到最新版
npm update -g @legna-lnc/legnacode

方式二：从源码编译

git clone https://github.com/LegnaOS/LegnaCode-cli.git
cd LegnaCode-cli
bun install
bun run compile
# 编译产物为 ./legna，可移动到 PATH 中

快速开始

# 交互模式
legna

# 非交互模式（直接提问）
legna -p "解释这段代码的作用"

# 继续上次会话
legna --continue

# 查看版本
legna --version

项目结构

├── src/
│   ├── entrypoints/       # 入口文件（cli.tsx）
│   ├── server/            # HTTP 服务器（admin WebUI）
│   ├── components/        # React/Ink 终端 UI 组件
│   ├── tools/             # 内置工具（Bash、文件操作、搜索等）
│   ├── services/          # API 调用、MCP 客户端、分析等
│   ├── native-ts/         # 纯 TS 实现的原生模块替代（语法高亮等）
│   ├── utils/             # 工具函数
│   └── hooks/             # React hooks
├── webui/                 # Admin WebUI 前端（React + Vite + Tailwind）
├── stubs/                 # 原生模块的 stub（编译时外部依赖占位）
├── scripts/               # 构建脚本
├── bunfig.toml            # Bun 构建配置（Feature Flags、宏定义）
└── package.json

构建说明

LegnaCode 使用 Bun 的 bundler 进行构建，支持两种模式：

  • bun run build — 构建到 dist/ 目录，适合开发调试
  • bun run compile — 编译为独立二进制 legna，无需 Bun 运行时

Admin WebUI

legna admin 启动一个浏览器管理面板，让你通过 Web 界面管理所有配置，无需手动编辑 JSON 文件。

# 启动管理面板（默认端口 3456，自动打开浏览器）
legna admin

# 自定义端口
legna admin 8080

面板顶部通过 Tab 切换管理对象：Claude (~/.claude/) 和 LegnaCode (~/.legna/)，每个 scope 下提供四个功能面板：

面板 功能
配置编辑 可视化编辑 settings.json：API 端点、API Key、模型映射（Opus/Sonnet/Haiku）、超时、权限模式、语言等
配置文件 列出所有 settings*.json，显示 baseUrl/model，一键切换激活配置
会话记录 浏览历史会话，显示项目路径、slug、时间、prompt 数量，一键复制 legna --resume 命令
配置迁移 Claude ↔ LegnaCode 双向迁移，支持全量或选择性字段迁移，迁移前预览 diff

从源码运行时需要先构建前端：cd webui && npm install && npm run build，然后 bun run src/server/admin.ts。npm 全局安装的版本已包含预构建的 WebUI。

构建时通过 bunfig.toml 中的 [bundle.define] 注入版本号等编译时常量，通过 [bundle.features] 控制 Feature Flags 实现死代码消除。

原生模块（color-diff-napi、modifiers-napi 等）标记为 external，运行时从 stubs/ 加载占位实现。语法高亮已切换为 src/native-ts/color-diff/ 下的纯 TypeScript 实现，无需任何原生编译依赖。

配置

LegnaCode 使用 ~/.legna/ 作为全局配置目录，项目级数据存储在 <project>/.legna/：

  • ~/.legna/settings.json — 全局用户设置
  • ~/.legna/.credentials.json — 认证凭据
  • <project>/.legna/sessions/ — 项目会话记录（JSONL）
  • <project>/.legna/skills/ — 项目技能
  • <project>/.legna/rules/ — 项目规则
  • <project>/.legna/settings.json — 项目级设置
  • LEGNA.md — 项目指令文件，AI 会自动读取并遵循

首次启动时自动从 ~/.claude/ 单向迁移全局数据到 ~/.legna/（不覆盖已有文件）。旧的 ~/.claude/projects/ 会话通过 fallback 链自动读取，无需手动迁移。设置 LEGNA_NO_CONFIG_SYNC=1 可禁止自动迁移。

legna migrate

手动迁移数据：

# 迁移全部（全局 + 当前项目会话）
legna migrate

# 仅迁移全局数据 ~/.claude/ → ~/.legna/
legna migrate --global

# 仅迁移当前项目会话到本地 .legna/sessions/
legna migrate --sessions

# 预览模式（不实际移动文件）
legna migrate --dry-run

环境变量

变量 说明
ANTHROPIC_API_KEY Anthropic API 密钥
CLAUDE_CODE_USE_BEDROCK 使用 AWS Bedrock 后端
CLAUDE_CODE_USE_VERTEX 使用 GCP Vertex 后端
CLAUDE_CODE_SYNTAX_HIGHLIGHT 设为 0 禁用语法高亮
MINIMAX_API_KEY MiniMax API 密钥（启用多模态工具）
MINIMAX_REGION MiniMax 区域：global（默认）或 cn
MINIMAX_BASE_URL 自定义 MiniMax API 地址（覆盖区域默认值）

MiniMax 多模态集成

当使用 MiniMax 模型（ANTHROPIC_BASE_URL 指向 api.minimax.io 或 api.minimaxi.com）且配置了 MINIMAX_API_KEY 时，LegnaCode 自动注册 6 个多模态原生工具，AI 可以直接调用。

配置

# 方式一：环境变量
export MINIMAX_API_KEY="your-api-key"
export MINIMAX_REGION="global"  # 或 "cn"

# 方式二：交互式配置（持久化到 ~/.legna/minimax-credentials.json）
legna
> /auth-minimax your-api-key

API key 获取：MiniMax 国际站 或 MiniMax 国内站

多模态工具

工具 功能 示例
MiniMaxImageGenerate 文字生成图像 "生成一张赛博朋克风格的城市夜景"
MiniMaxVideoGenerate 文字/图像生成视频 "把这张图片做成一段 5 秒的动画"
MiniMaxSpeechSynthesize 文字转语音 "把这段文字转成语音朗读"
MiniMaxMusicGenerate 文字生成音乐 "生成一段轻快的钢琴背景音乐"
MiniMaxVisionDescribe 图像理解分析 "描述这张图片的内容"
MiniMaxWebSearch 网页搜索 "搜索最新的 TypeScript 5.x 特性"

工具仅在使用 MiniMax 模型时自动启用，不影响其他模型的工具列表。

多模态工作流

AI 可以自动编排多个工具完成复杂任务：

用户：帮我做一个项目宣传视频

AI 自动编排：
1. 分析项目 README，提取核心卖点
2. MiniMaxImageGenerate → 生成关键帧图片
3. MiniMaxVideoGenerate → 基于关键帧生成视频
4. MiniMaxSpeechSynthesize → 生成旁白配音
5. 返回所有生成资源的 URL

Schema 导出

MiniMax 工具的 schema 可以导出为 Anthropic 兼容格式，用于外部集成：

import { exportMiniMaxToolSchemasJSON } from './src/tools/MiniMaxTools/schemaExport.js'
console.log(exportMiniMaxToolSchemasJSON())

许可证

本项目遵循上游 Claude Code CLI 的开源许可协议。详见 Claude Code CLI 原始仓库。

相关链接

About

基于 ClaudeCode-CLI 源码进行修复完成的项目

Resources

Readme
Activity

Stars

13 stars

Watchers

0 watching

Forks

11 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages