mixdog

Mixdog is a standalone coding agent for orchestrated, multi-provider workflows. Use it from a full-screen terminal UI or the Windows desktop app.

Get started

Windows desktop

Download Mixdog Desktop for Windows (x64)

The desktop package is currently unsigned, so Windows SmartScreen may show a security warning during installation.

CLI

Requires Node.js >= 22.

npm install -g mixdog
mixdog

First run guides you through provider authentication, model selection, and workflow setup.

Highlights

• Multi-provider routing — assign different providers and models by role.
• Efficient context — cache-aware prompts, compaction, resumable sessions, and focused repo-native tools.
• Complete coding surface — read, search, edit, test, review, web search, MCP, skills, hooks, and plugins.
• Local memory — semantic and lexical recall with project-scoped context and multilingual retrieval.
• Remote workflows — optional web relay, Discord, Telegram, voice, and cron schedules.
• Windows desktop app — agent panes, Monaco editor, git, terminal, file explorer, Studio, automation, and settings in one workbench.

Providers

Mixdog supports subscription OAuth and API-key routes, including:

• Anthropic and Claude accounts
• OpenAI and ChatGPT/Codex accounts
• Google Gemini
• xAI Grok
• DeepSeek and OpenCode Go
• OpenAI-compatible APIs
• Ollama and LM Studio

The model picker combines live provider catalogs with model metadata for context limits, pricing, tool support, reasoning, and recency.

Run

# Start in the current project
mixdog

# Select a provider and model
mixdog --provider anthropic-oauth --model claude-haiku-4-5-20251001

# Select a workflow
mixdog --workflow solo

# Use read-only tools
mixdog --readonly

# Enable remote and channel features
mixdog --remote

# Run onboarding again
mixdog --onboarding

Run mixdog --help for the complete option reference.

Headless exec

mixdog exec runs one non-interactive, single-model session with ephemeral configuration. It requires an explicit provider and model:

mixdog exec --provider anthropic-oauth --model claude-opus-5 "fix the failing test"
mixdog exec --provider openai-oauth --model gpt-5.6-sol --effort xhigh --fast "review the current diff"
mixdog exec --provider openai-oauth --model gpt-5.6-sol --json "fix the failing test"

Web search and memory are disabled by default in headless runs. Enable them per run when needed:

mixdog exec --provider openai-oauth --model gpt-5.6-sol --web-search "research this issue"
mixdog exec --provider openai-oauth --model gpt-5.6-sol --memory "continue the previous work"

Without --web-search, shell child processes use an offline network policy while loopback remains available. --json emits timestamped JSONL events to stdout; diagnostics remain on stderr.

TUI commands

/providers   configure provider authentication and local endpoints
/model       choose the main provider and model
/workflow    choose the active workflow
/agents      inspect agents and model overrides
/project     switch the current project
/resume      resume a saved session
/memory      inspect and edit core memory
/mcp         manage MCP servers and tools
/skills      select a skill
/channels    manage remote channels
/compact     compact older context
/setting     open settings
/update      check for updates
/doctor      diagnose installation health

Workflows and agents are Markdown definition packs (WORKFLOW.md, AGENT.md). Built-in packs ship with Mixdog; custom packs live under the Mixdog data directory.

Windows desktop app

Mixdog Desktop runs the same agent runtime as the CLI in an Electron workbench:

• Split panes for parallel, independently routed agent sessions
• Monaco editor, LSP integration, diffs, and turn-by-turn edit review
• Git staging, commits, branches, and generated commit messages
• Windows file explorer with previews, thumbnails, and drag-and-drop
• Integrated PowerShell and ConPTY terminal tabs
• Image and video generation Studio with a persistent local gallery
• Visual workflow, agent, and schedule editors
• Provider setup, usage, git identity, and remote pairing settings

For desktop development:

cd apps/desktop
npm run dev

Terminal-Bench 2.1

Controlled single-model runs on the same 89 tasks produced:

• 78/89 with Claude Opus 5 vs Claude Code's 77/89
• 75/89 with GPT-5.6 Sol xhigh, matching Codex CLI
• 1.43× faster vs Claude Code and 1.27× faster vs Codex CLI
• 40–47% smaller median final context
• 29% lower priced cost vs Claude Code and at least 39.7% lower vs Codex CLI

These are self-reported single runs (k=1, 2026-08), not leaderboard submissions. Raw artifacts, commands, comparison charts, and metric scripts live under benchmarks/terminal-bench-2.1/.

Data and configuration

Mixdog uses ~/.mixdog as its home root and ~/.mixdog/data for runtime data by default.

MIXDOG_HOME=/path/to/home mixdog
MIXDOG_DATA_DIR=/path/to/data mixdog

Useful environment variables:

• MIXDOG_TUI_MOUSE=0 — use terminal-native mouse behavior.
• MIXDOG_DISABLE_MODEL_PREFETCH=1 — disable provider model prefetch.
• MIXDOG_MODE=ship|dev — select shipping or development diagnostics.
• MIXDOG_DIAGNOSTICS=1 — force diagnostic trace and log output.

Development

npm install
npm start

npm run smoke
npm run smoke:all
npm run test:tool-contracts
npm run build:tui
npm run audit:models

Main directories:

src/            CLI, TUI, runtime, workflows, agents, and rules
apps/desktop/   Windows desktop workbench
apps/relay/     remote web relay
native/         native process, search, patch, and support binaries
scripts/        tests, diagnostics, benchmarks, and build scripts
vendor/         vendored runtime components

License

MIT