mncode-desktop

mncode Desktop

Native desktop cockpit for the mncode Go agent core — visual subagent swarms, PTY multi-terminal, sidecar chat, and real-time quota HUD, wrapped in a Wails v2 shell.

Highlights

• Streaming agent chat — token-level streaming with tool/subagent activity feed, run summaries (duration + token usage persisted across restarts), and steering support
• Workspace inspector sidecar — file tree, agent activity, side notes, and usage telemetry in a resizable right panel
• Built-in PTY terminal — real terminal session rooted at the workspace (⌘J)
• Skills Marketplace — curated free skills from MCP Market & skills.sh, installed into the shared ~/.mncode/skills directory
• Automations — scheduled (cron) and idle-time agent tasks with run history and keep-awake; see docs/AUTOMATIONS.md
• Multi-provider models — Antigravity, OpenAI Codex, OpenCode, OpenRouter, and custom OpenAI-compatible providers with account pools and quota HUD
• Multi-engine web search — agent-invoked Google Grounding, Tavily, Brave, and DuckDuckGo with engine selection and local key setup in Settings → General
• Remote companion — pair a phone to steer runs from the couch
• Personalization — custom instructions, personality modes (including Brainrot 🧠), and local memories
• RMIT-inspired design system — dark-void surfaces, hairline grids, bracket eyebrows, pink/cyan HUD accents, light & dark themes
• Power Tools cockpit - Drift Sentinel, Sandbox Fixture Runner, local Code Index, Red Team Arena, Flight Recorder, and Spec Contract Matrix views.
• Replay controls - Start and stop redacted lifecycle recording from Desktop, inspect traces, and fork completed traces into a new chat.

Stack

Layer	Tech
Shell	Wails v2.12 (Go ↔ webview bridge)
Core	mncode-cli Go agent core (via replace mncode => ../mncode-cli)
Frontend	React 19 + Vite + TypeScript
Styling	Tailwind CSS v4 + shadcn-style components on Radix primitives

Keyboard shortcuts

Keys	Action
⌘N	New chat
⌘K	Command palette
⌘,	Open settings
⌘J	Toggle terminal
⌘1–9	Open the matching chat
⌘ + / ⌘ −	Step UI font size (11–20px)
⌘0	Reset UI font size to 15px
?	Keyboard shortcuts dialog
Esc	Close the active menu or dialog

Development

Requirements: Go 1.24+, Wails CLI v2 (go install github.com/wailsapp/wails/v2/cmd/wails@latest), Node 20+ with pnpm.

pnpm install
wails dev

The Wails browser dev bridge is available at http://localhost:34115. For a frontend-only preview, run pnpm --dir frontend dev.

Set MNCODE_WORKSPACE to open a workspace automatically:

MNCODE_WORKSPACE=/absolute/path/to/project wails dev

Build

GOTOOLCHAIN=local go test ./...
pnpm --dir frontend build
wails build

The packaged app lands in build/bin.

Project structure

mncode-desktop/
├── main.go                  # Wails bootstrap and window setup
├── app.go                   # App facade: workspace, providers, agent turns
├── app-types.go             # JSON wire types shared with the frontend
├── desktop-session.go       # Agent session construction and lifecycle
├── desktop-events.go        # Agent-core callbacks → Wails DOM events
├── catalog.go               # Settings, themes, models, prompt catalog
├── providers.go             # Provider accounts, quotas, custom providers
├── skills-marketplace.go    # Skill install/delete + curated catalog bridge
├── terminal.go              # PTY terminal panel bridge
├── remote.go                # Phone companion session management
├── usage.go                 # Local usage telemetry aggregation
├── version.go               # Version metadata and update checks
├── docs/                    # Architecture and skills documentation
└── frontend/
    └── src/
        ├── App.tsx          # Root shell, views, event wiring, chat history
        ├── style.css        # Design tokens + RMIT utility classes
        ├── components/      # Sidebar, composer, inspector, settings, ...
        └── lib/             # Wails bindings and helpers

See docs/ARCHITECTURE.md for how the layers talk to each other and docs/SKILLS.md for how the marketplace catalog works.

Privacy

Everything runs locally: workspace scanning, agent turns, and usage telemetry stay on this machine. Provider, account, and optional search credentials are persisted in ~/.mncode/config.json; the ~/.mncode directory is 0700 and the config file is 0600. Desktop Settings accepts search keys through password inputs and returns only configured/not-configured status. Optional mncode account sign-in only syncs settings and usage summaries you explicitly push.

License

MIT © 2026 mncode