Mensa CLI

mensa cli

](https://www.npmjs.com/package/mensa-cli) 

Claude AI强大的基于终端的聊天界面，使用Bun、React和Ink构建。由 Claude代理SDK 获得具有完整工具使用功能的代理体验。

想想克劳德代码，但在你的终端上有一个干净的TUI。

✨ 亮点

• 🤖 AI 代理 -Claude可以读/写文件、运行命令、搜索网络等
• 💬 会话管理 -跨终端会话继续对话
• 🔌 MCP支持 -连接到模型上下文协议服务器以扩展功能
• 💰 预算控制 -设定支出限额以管理成本
• ↩️ 撤消支持 -还原Claude所做的文件更改
• 🎨 美丽的TUI -Markdown渲染、语法高亮显示和精美的界面

📋 目录

• 安装
• 快速开始
• 特性
• 配置
• 键盘快捷键
• 文档
• 发展
• 贡献
• 许可证

安装

先决条件

• 包子 运行时（v1.0+）
• 活跃 克劳德代码 订阅（mensa使用您的Claude Code身份验证）

来自npm

bun install -g mensa-cli

来源

git clone https://github.com/FujiwaraChoki/mensa-cli.git
cd mensa-cli
bun install
bun run build
bun link

快速开始

1. 验证 -确保您已登录 克劳德代码.mensa使用相同的身份验证。

1. 启动mensa：

   mensa

1. 首次运行 -您将在选型过程中得到指导（建议使用Sonnet 4.5）。

1. 开始聊天！ 键入您的信息，然后按Enter键。

特性

代理工具

mensa为Claude提供了强大的工具：

会话管理

无缝地继续之前的对话：

mensa                    # Start new session
mensa --continue         # Resume most recent session
mensa -c                 # Short form
mensa --resume       # Resume specific session by ID

撤消支持

犯了一个错误？使用 /undo 还原上次助理响应中的文件更改。状态栏显示何时可以撤消。

MCP集成

连接到 模型上下文协议 用于扩展功能的服务器：

# Add a filesystem MCP server
mensa mcp add fs --command "npx" --args "@modelcontextprotocol/server-filesystem ."

# Add a remote HTTP MCP server
mensa mcp add api --url "https://api.example.com/mcp" --type http

# List configured servers
mensa mcp list

查看完整 MCP文件 了解更多详情。

预算限额

设定支出限额以控制成本：

mensa budget set 5.00   # Set $5 limit
mensa budget show       # View current limit
mensa budget clear      # Remove limit

状态栏显示您当前的支出与预算限制。

斜杠命令

类型 / 在聊天中查看可用命令：

配置

配置存储在 ~/.mensa/config.json:

{
  "model": "claude-sonnet-4-5-20250929",
  "createdAt": "2024-01-01T00:00:00.000Z",
  "mcpServers": {},
  "maxBudgetUsd": 10.00,
  "lastSessionId": "session-uuid"
}

可用模型

使用 /config 或 /settings 在应用程序中更改模型：

键盘快捷键

文档

• 命令参考 -CLI和应用内命令的完整列表
• MCP服务器 -设置模型上下文协议服务器

发展

本地运行

# Install dependencies
bun install

# Run in development mode
bun run dev

# Build the binary
bun run build

项目结构

mensa-cli/
├── src/
│   ├── index.tsx        # Entry point
│   ├── App.tsx          # Main app component
│   ├── components/      # React/Ink components
│   ├── hooks/           # Custom React hooks
│   ├── screens/         # Screen components
│   ├── utils/           # Utility functions
│   └── types.ts         # TypeScript types
├── docs/                # Documentation
└── dist/                # Compiled binary

贡献

欢迎投稿！请随时提交拉取请求。

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add some amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

故障排除

身份验证问题

mensa使用您的Claude Code身份验证。请确保您已登录：

1. 安装 克劳德代码 如果你还没有
2. 在Claude Code中完成身份验证流程
3. 试着跑步 mensa 再次

会话未恢复

会话存储在本地 ~/.mensa/。如果清除此目录，会话历史记录将丢失。

MCP服务器未连接

1. 检查服务器是否已配置： mensa mcp list
2. 验证命令/URL是否正确
3. 如果需要，请检查身份验证标头
4. 看 MCP文件 详细故障排除

许可证