mesalogo
d08ba33c3e
OpenCode child cards now show ordered text, reasoning and tool progress, with the final result displayed separately. Local SDK and remote ACP paths share child tracking, including progress retained across recovery and cancellation. Remote live progress requires an Agent package containing the event plugin; older Agent packages still expose final results without inventing missing history. Knowledge-library rows remain clickable when native label activation changes focus. File workspace changes use colored Git status letters and per-file staged/unstaged diffs, including deleted, renamed and untracked files. Refreshing reloads the selected diff and expanded directories, and more than 50 changes remain accessible through incremental loading. Validated with 3552 passing tests, typecheck, lint, desktop build, current-source Linux Host scenarios and isolated Windows desktop UI interactions. Release note: 展开 OpenCode 子代理卡片可查看执行过程、工具详情与独立最终结果；知识库支持整行勾选。工作区支持单文件暂存与未暂存差异，刷新会更新当前差异，更多变更可继续加载。远端实时过程需要更新 GoodBuddy Agent。
GoodBuddy
Desktop access to model chat, coding agents, knowledge, and scheduled work
English | 简体中文
Website · Download · Feature Matrix · Build Guide
GoodBuddy is a desktop application for model chat, coding agents, knowledge retrieval, notes, and scheduled tasks. No GoodBuddy account is required. Workspace data is stored locally by default. Model endpoints can run on the same device, on a private network, or at a provider selected by the user.
Highlights
- Local-first workspace: No GoodBuddy account is required. Workspace data stays local by default, and users choose where model services run.
- Unified Agent Runtimes: Use direct models, OpenCode, Continue, and the preview DeepSeek Harness from one desktop interface.
- Explicit execution boundaries:
Askremains read-only, whileExecuteuses the current account's permissions. Tool activity, cancellation, timeouts, and token usage are recorded. - Broad platform coverage: Official Linux releases cover
x64andarm64, including compatible distributions used in China's domestic computing ecosystem. A separate experimentalloong64preview is available for LoongArch systems. - Knowledge and long-running work: Knowledge bases, graphs, Magic Notes, tasks, and Smart Heartbeat share one desktop workspace.
Platform coverage describes operating-system, instruction-set, and package compatibility, not certification for every hardware vendor or distribution release. LoongArch is outside the official release matrix; see the LoongArch preview notes for its current limitations.
Capabilities
| Area | Available in GoodBuddy |
|---|---|
| Agent Runtimes | Direct model connections, OpenCode, Continue, and the preview DeepSeek Harness |
| Data and execution | Local SQLite storage, read-only Ask, full-account Execute, and recorded tool activity |
| Knowledge | File, folder, and web imports with full-text, Chinese phrase, vector, and knowledge graph retrieval |
| Desktop releases | Official Windows, macOS, and Linux builds for x64 and arm64, plus an experimental LoongArch preview |
| Integrations | Local or hosted model endpoints, custom MCP servers, WeChat ClawBot, WeCom, and DingTalk |
Product tour
Knowledge bases and graphs
Magic Notes and Smart Heartbeat
Agent Runtimes
| Runtime | Functions | Configuration |
|---|---|---|
| Direct models | Chat, retrieval, image generation, and built-in tools | GoodBuddy model connections |
| OpenCode | Coding agents, native commands, tools, and skills | GoodBuddy-managed or native OpenCode configuration |
| Continue | Rules, prompt presets, and coding tasks | GoodBuddy-managed or native Continue configuration |
| DeepSeek Harness (preview) | A fixed host with optional plugin capabilities | GoodBuddy-managed OpenAI-compatible connection |
Each run reports cancellation, timeouts, token usage, tool calls, and history. Runtime-specific capabilities and configuration remain separate.
Download
Download a build from GitHub Releases:
| Platform | Architectures | Formats |
|---|---|---|
| Windows | x64, arm64 |
NSIS, portable ZIP |
| macOS | x64, arm64 |
DMG, ZIP |
| Linux | x64, arm64 |
AppImage, DEB, RPM |
The experimental LoongArch loong64 build is distributed through a separate
preview channel on the product website.
Desktop installers do not contain remote Agent payloads. Local projects do not need an Agent package; managed SSH users download or import one explicitly in Settings.
Code signing and macOS notarization are not configured yet, so the operating system may display a security warning.
Run from source
Requires Node.js 24 and npm:
git clone https://github.com/mesalogo/goodbuddy.git
cd goodbuddy
npm ci
npm run dev
See BUILD.md for build and packaging instructions.
Documentation
- Feature matrix and roadmap
- Product feature documentation
- UI design system
- Build and packaging
- Release runbook
Privacy and execution boundaries
- Model requests are sent only to services selected by the user.
- Local data stays in the operating system's application data directory by default. API keys are encrypted by secure system storage.
- The Renderer has no access to raw Electron APIs or model credentials.
- The DeepSeek Harness plugin marketplace is off by default. Third-party install scripts, initialization code, and Execute tools run with the current user's permissions.
- Remote delegation is enabled only after the user configures an endpoint and token.
- Private-network compatibility permits in-app HTTP and non-standard HTTPS certificates. WeChat credential and media endpoints remain strictly validated.
Contributing
Issues and pull requests are welcome. Read AGENTS.md first, then run:
npm test
npm run typecheck
npm run lint
Community communication
Scan the QR code to join the GoodBuddy WeChat group:
License
Original GoodBuddy code is released under the 0BSD License. You may use, modify, distribute, and commercialize it freely. Third-party components and resources retain their respective licenses.