Repository navigation
v0.1.0
The first public release.
Added
- Desktop app for Windows, macOS and Linux, with the engine built in. It checks for updates and installs them where the platform allows (unsigned macOS builds and the Linux deb point to the download page instead).
merakcommand line (no UI):merak runfor one-off tasks,merak serveto run only the engine andmerak acpfor editors.- TypeScript SDK
@merakcode/sdk: start or connect to an engine, run sessions, handle approvals and questions, and give the model your own tools. - Eight built-in model providers (OpenAI, Anthropic, Google, Alibaba Cloud Model Studio, Zhipu AI, DeepSeek, Moonshot AI, OpenRouter), plus any OpenAI-compatible API configured with an API key.
- Three permission modes (read-only, ask, auto) with per-project rules.
- An OS sandbox for agent commands on Windows (separate account, NTFS permissions, firewall), Linux (Landlock) and macOS (Seatbelt), with
merak sandbox status|setup|reset. - Error codes (
MRK-xxxx) on every user-facing error, listed indocs/errors.md. merak doctor,merak logsandmerak bug-reportfor troubleshooting.merak upgrade(aliasupdate) for script and npm installs.- Chinese and English UI.
首个公开发布的版本。
新增
- Windows、macOS 和 Linux 桌面客户端,自带引擎。会检查更新,平台允许时直接安装(未签名的 macOS 版和 Linux 的 deb 包改为提示去发布页下载)。
- 没有界面的
merak命令行:merak run跑一次性任务,merak serve只启动引擎,merak acp接到编辑器里用。 - TypeScript SDK
@merakcode/sdk:启动或连接引擎、运行会话、处理审批和提问,还能把自己的工具交给模型调用。 - 内置八家模型服务商(OpenAI、Anthropic、Google、阿里云百炼、智谱、DeepSeek、月之暗面、OpenRouter),其他服务可以用 API 密钥接入 OpenAI 兼容接口。
- 三种权限模式(只读、询问、自动),可以按项目设置规则。
- 智能体执行的命令放进系统沙箱:Windows(独立账户、NTFS 权限、防火墙)、Linux(Landlock)和 macOS(Seatbelt),用
merak sandbox status|setup|reset管理。 - 所有面向用户的错误都带错误码(
MRK-xxxx),清单见docs/errors.md。 - 排查问题用的
merak doctor、merak logs和merak bug-report。 merak upgrade(别名update),用于脚本安装和 npm 安装的升级。- 中文和英文界面。