mixdog README

The project's README from github.com/tribgames/mixdog. As one markdown file: README.md.

Mixdog

Mixdog

The open-source coding agent that uses 63% fewer tokens.
Download ↓

https://github.com/user-attachments/assets/af515dc9-b0fb-4b6a-aaa1-1d82db792ed0

Download for Windows   Download for macOS   Download for Linux
macOS button is for Apple Silicon (M1 and later). Intel Mac? Download for Intel Mac. Linux button is the x64 AppImage; .deb and ARM64 builds are listed below.

Release npm License

Website · Benchmarks · Docs

Highlights

Installation

Download the desktop app:

Platform Download
Windows (x64) mixdog-desktop-win-x64.exe
macOS (Apple Silicon) mixdog-desktop-mac-arm64.dmg
macOS (Intel) mixdog-desktop-mac-x64.dmg
Linux (x64, AppImage) mixdog-desktop-linux-x86_64.AppImage
Linux (x64, .deb) mixdog-desktop-linux-amd64.deb
Linux (ARM64, AppImage) mixdog-desktop-linux-arm64.AppImage
Linux (ARM64, .deb) mixdog-desktop-linux-arm64.deb

Then sign in with a ChatGPT, Claude, Grok, or Muse Code account, or paste an API key. A five-step tutorial walks you through the rest.

[!NOTE] The Windows installer is not code-signed yet. If SmartScreen appears, choose More info → Run anyway. The Mac app is signed and notarized.

Or run it in the terminal (Node.js 22.19+ or 24+):

npm install -g mixdog
mixdog
Supported providers
  • Anthropic API keys and Claude account OAuth
  • OpenAI API keys and ChatGPT/Codex account OAuth
  • Google Gemini API keys
  • xAI API keys and Grok account OAuth
  • Muse Code (Meta) account OAuth
  • OpenRouter, DeepSeek, and OpenCode Go
  • Built-in Local Provider — download and run models in the app (Windows x64 with an NVIDIA GPU)

Cursor, Antigravity (Gemini), and MiMo OAuth are off by default under Settings → Developer; using them through OAuth risks account restrictions.

Headless mixdog exec

mixdog exec runs one non-interactive, single-model session without personal memory, prior sessions, skills, MCP servers, or plugins:

mixdog exec --provider openai-oauth --model gpt-5.6-sol --effort xhigh "fix the failing test"

Web search is off by default (--web-search enables it). This does not block shell networking — headless exec is not an offline sandbox. Run mixdog --help for the full reference.

Benchmarks

Bar chart: Mixdog vs Codex CLI on Terminal-Bench 2.1

All 89 Terminal-Bench 2.1 tasks × 5 trials on GPT-5.6 Sol xhigh, scored by the official Harbor verifier.

Mixdog used fewer tokens on 87 of 89 tasks. With Claude Opus 5, it solved 2 more tasks than Claude Code at 19% lower cost. Every verdict, log, and script is published in benchmarks/terminal-bench-2.1/, and Context efficiency explains where the savings come from.

Documentation

Feedback

Found a bug or missing a feature? Open an issue. If Mixdog saves you tokens, a star helps others find it.

License

Mixdog is licensed under Apache-2.0. Third-party components retain their respective licenses; see NOTICE.md.

mixdog (tribgames/mixdog)

Searching Database…

143 ·GitHub
What is this?Mixdog is an open-source desktop coding agent that matches OpenAI's Codex on the Terminal-Bench 2.1 benchmark while using 63% fewer tokens. It bundles an editor, terminals, Git/GitHub integration, and multi-model orchestration into one app.
Is it a desktop app or a CLI tool?It's primarily an Electron desktop app for Windows, macOS, and Linux, but it also ships a Node.js-based CLI with a headless 'mixdog exec' mode for non-interactive runs.
How do I install and set it up?Download the prebuilt desktop app for your platform (Windows exe, macOS dmg for Apple Silicon or Intel, Linux AppImage/.deb), then sign in with a ChatGPT, Claude, Grok, or Muse Code account or paste an API key; an in-app five-step tutorial covers the rest.
Which AI providers and accounts can I use with it?It supports Anthropic, OpenAI, Google Gemini, and xAI API keys or account OAuth, Muse Code (Meta) OAuth, OpenRouter, DeepSeek, OpenCode Go, and a built-in local provider that runs models on an NVIDIA GPU (Windows x64 only).
Any install pitfalls I should know about?The Windows installer isn't code-signed yet, so Windows SmartScreen may warn on first run (pick 'More info → Run anyway'); the Mac app is signed and notarized. The headless 'mixdog exec' mode also skips personal memory, prior sessions, skills, MCP servers, and plugins, and is not a network-isolated sandbox.
Is it safe to continue a session from my phone?Yes, the README states that continuing sessions from your phone is end-to-end encrypted.
What is 'auto reasoning effort'?A built-in 150MB model running locally on the CPU judges, in about 0.1 seconds, how much reasoning effort each message or tool step needs, and it's on by default to save tokens without manual tuning.
What does scaling from 'Solo to Swarm' mean?Mixdog can run with a single model doing everything (Solo) or mix models by role, where a strong model leads while cheaper models search, edit, and review in parallel (Swarm).
How does it compare to Codex and Claude Code in benchmarks?Across all 89 Terminal-Bench 2.1 tasks run 5 times on GPT-5.6, Mixdog used fewer tokens than Codex CLI on 87 of 89 tasks, and with Claude Opus 5 it solved 2 more tasks than Claude Code at 19% lower cost.
Can it do more than just write code?Yes — beyond coding, it can control a browser and desktop, work with Office and PDF documents, and generate images and video.
Creator
tribgames
Size
255.7 MB
Stars
143
Age
3mo
Commits · 90 Days