Skip to content

Marionette v0.0.1

Choose a tag to compare

@nt-cubic nt-cubic released this 06 Aug 12:56
· 7 commits to master since this release

Marionette v0.0.1 — Portable

单文件 Windows 可执行程序,无需安装包。双击即用。

下载

  • Marionette.exe(约 1.22 MB)— 拷到任意位置双击即可

系统要求

  • Windows 10 / 11
  • Microsoft Edge WebView2 Runtime(较新系统一般已自带)
  • 若缺失,启动时会弹窗并给出官方下载链接(不会静默安装)

本版本更新

首个面向日常使用的便携版发布。Marionette 是一个多 Agent CLI 图形壳:不替代 OpenCode / Claude Code / Codex / Grok 等原厂 agent,只负责启动、展示、切换、记录与 handoff。

核心能力

  • 一个窗口,所有 Agent — Claude Code、OpenCode、Codex、Grok Build 等,按需懒启动,不占空闲资源
  • 切换 Agent 不断上下文 — 自动生成 handoff Markdown,支持对话接力
  • MCP / Skills 统一管理 — 扫描一次,多 Agent 共享
  • 轻量便携 — 单文件约 1.2MB,内存占用克制

对话与交互

  • 统一消息卡片:思考过程可折叠,工具调用清晰
  • 对话目录 / 消息批注 / 图片批注(点选框选直指要改处)
  • edit & resend、权限弹窗、Ask Question / Plan 审批
  • @ 委派:消息里点名另一个 Agent,上下文自动交接
  • 智能回复气泡(拖入文件、选项、报错、继续执行等场景)
  • 发送键可切换:右键发送按钮,在 Enter 与 Ctrl+Enter 间切换

项目与窗口

  • 项目拖拽排序、会话按最近发送时间排序
  • Tab 撕出多窗口(幽灵预览后独立窗)
  • 多窗口状态同步;关窗防闪退与隐藏壳回收
  • 侧栏打开项目文件夹 / 资源管理器

用量与登录

  • 右侧栏展示上下文用量
  • ChatGPT / Claude / Codex / Grok 等额度与限流信息
  • 各内置 Agent 登录状态探测 + Sign in 引导

记忆与稳定性

  • 会话 JSONL 持久化,重开不丢、可搜索
  • Git 感知:改动文件列表与只读 diff
  • 记忆每个 Agent 上次使用的 model / effort / mode,新会话自动沿用
  • 冷会话剪枝、虚拟列表、图片卸载,降低内存
  • 流式输出清洗(去掉 transport 标记与运行时元数据)
  • Codex full-access 模式发送前重同步;Grok 始终批准偏好
  • OpenCode 鉴权类型与未登录状态修正
  • Windows 关闭崩溃修复(tao paint re-entry)

其他

  • 自定义 ACP agents、应用更新入口
  • Tasks 项目级 Todo(手写增删、换 Agent 不丢,可吸收 AI Plan)

说明

  • 未代码签名,首次运行可能被 SmartScreen 拦截(「更多信息」→ 仍要运行)
  • 应用数据目录:%USERPROFILE%\.marionette 与项目下 .marionette
  • 本机构建:build-portable.batnpm run build:portable

快速下载

gh release download v0.0.1 --clobber -p Marionette.exe