Maka Agent TUI 终端界面完全教程把终端变成 AI Agent 工作站【免费下载链接】makaApache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.项目地址: https://gitcode.com/GitHub_Trending/mak/makaMaka 是一个本地优先local-first的 AI Agent 工作空间它的 TUI 终端界面让你用一条命令把普通命令行变成 AI Agent 工作站模型消息、工具调用、权限决策全部记录在只追加的本地日志中会话可随时恢复。本教程带你从安装到进阶命令完整掌握 Maka 终端 AI Agent 界面。为什么选择 Maka 终端 TUI本地优先会话、设置、执行记录默认全部留在你的机器上模型连接由你自己选择云端 API、本地模型或兼容网关日志即运行时模型消息、Tool Call、Tool Result 和终止事件都写入 Runtime Event Log会话与界面只是日志的投影天然支持恢复与回放双入口交互式 TUImaka与非交互 CLImaka run共享同一套工作空间与模型连接日常对话和脚本化任务都能覆盖️内置本地工具Read、Write、Edit、Bash、Glob、Grep开箱即用高权限操作默认先询问。 核心理念Context 不等于历史。工具结果修剪和 LLM 压缩改变的是“下一次推理看到什么”而不是把已记录的证据当成可丢弃的上下文。一键安装步骤最快配置 Maka CLI环境要求Node.js 22.19 或更高版本一个支持交互输入的终端。Grep工具需要系统安装ripgrep。# 安装beta 阶段请显式指定 next 标签 npm install --global maka-agentnext # 验证安装 maka --version maka --help一次性试用也可以用npx --yes maka-agentnext无需全局安装。升级时请继续带上next标签避免 npm 全局更新误选到latest发布线。首次运行3 步接入你的模型进入你希望 Agent 工作的项目目录然后启动 TUIcd path/to/project maka首次启动会自动打开供应商设置向导选择供应商、输入 API Key、勾选要启用的模型并保存之后随时用/setup添加或更新供应商用/model在已连接的模型间切换回到输入框直接下达第一个任务例如总结这个仓库并指出最高风险的部分。API Key 与工作空间状态保存在本机Makaprofile 中macOS~/Library/Application Support/MakaLinux~/.config/MakaWindows%APPDATA%\Maka由操作系统账号边界保护POSIX 系统上强制 owner-only 权限。认识 TUI 界面你的 AI Agent 工作站TUI 由上到下分为四个区域布局实现见packages/cli/src/pi-tui-layout.ts区域作用Transcript 记录区展示对话、模型思考与工具调用时间线滚动使用终端自身回滚长输出永不被截断Activity 活动条Turn 运行时实时显示Working… 12s这类进度Pending 队列条展示 Turn 运行中你排队追加的指令Steering/QueuedEditor 输入区 状态行带自动补全的输入框底部状态行显示模型、上下文用量、权限模式几个贴心的小细节长任务在你切走焦点后完成时终端会响铃提醒注意力机制见packages/cli/src/tui-attention.tsShell 任务运行时还带实时计时器随时掌握等待时长。常用斜杠命令速查表掌控 AI Agent 会话以下命令可在 TUI 输入框直接键入完整目录定义于packages/core/src/slash-command-catalog.ts命令用途/setup添加或更新模型供应商/model切换当前模型/thinking调整思考等级/context查看上下文占用诊断/compact手动压缩历史释放上下文/recap生成一句话会话回顾/rewind、/move会话回溯与修订跳转/rename、/session重命名 / 管理会话/resume恢复指定会话/permissions查看权限模式/skill调用技能Skills/graph开启多智能体图执行/help、/exit帮助 / 退出实用技巧Agent 正在工作时也可以继续输入——新指令会进入 Pending 队列排队等当前 Turn 结束后依次执行不用干等。非交互模式maka run 一行命令跑完任务不想开 TUI 时用非交互 Turn 执行单轮任务# 执行一次任务并输出结果 maka run 总结这个项目并指出风险最高的部分 # 等价别名 maka -p 同样的一句话⚠️权限提醒默认情况下高权限工具操作会先征求同意。maka run --yolo会授予任务完整的文件与网络访问权限只应在你确实允许任务随意修改的环境如容器、沙箱中使用。会话丢失或目录移动用命令行参数直接恢复maka --resume session-id maka --resume session-id --cwd /path/to/moved/dir进阶玩法/graph 多智能体协作Maka 支持把大任务拆成多个独立切片并行实现再集成评审。在 TUI 中键入/graph on或/graph 任务开启命令行则使用maka run --graph 实现两个独立切片集成后评审结果注意两点非交互的--graph会等待持久的 Graph 执行完成后再打印最终 supervisor 输出Graph 的实现算子使用隔离的 Git worktree并行开发因此源项目必须是一个干净的 Git worktree。相关协议与执行链路集中在packages/runtime/src/的 stream-graph 系列模块中。数据都存在哪里Maka 是严格的本地优先 AI Agent所有会话消息、执行台账、用量与 Artifact 元数据落在单个runtime.sqlite中唯一操作权威Artifact 文件本体存放在artifacts/目录。卸载 CLI 不会删除这些数据——只有你主动备份并删除 profile 目录时才会清除操作前请先关闭 CLI 和 Desktop 应用。常见问题排查找不到maka命令确认 npm 全局可执行目录已加入PATH用node --version、npm --version、maka --version记录三个版本再排查没有可用模型启动 TUI 执行/setup重新走一遍供应商设置Grep 工具不可用安装ripgrepmacOSbrew install ripgrepCLI 仍在快速迭代命令与本地数据格式在稳定版前可能变化升级前留意官方说明。更多细节见 packages/cli/README.zh-CN.md 与根目录的 README.zh-CN.md。小结场景推荐姿势日常对话与文件工作流项目目录下maka启动 TUI脚本化 / CI 中的单轮任务maka run 任务大任务并行拆解maka run --graph 任务恢复中断的会话maka --resume session-id从安装到多智能体协作Maka 的 TUI 终端界面让 AI Agent 真正住进了你的命令行——本地数据、可恢复的日志、可插拔的模型连接正是这台终端工作站的核心价值。【免费下载链接】makaApache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.项目地址: https://gitcode.com/GitHub_Trending/mak/maka创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考