Menu
Build, test, package, and release Mako Desktop and the Mako Local Agent. Use when changing packages/desktop, packages/local-agent, shipping a new desktop version, or debugging the desktop release pipeline.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Load when building, editing, or debugging Mako React apps — app files, npm dependencies, data bindings, the @mako/app-sdk hooks (useQuery / useDuckDB / useLocation / useSearchParams / navigate), URL state and shareable deep links, materialized Parquet/DuckDB bindings, and the live preview runtime.
Load for dbt branches, commits, pushes, pull requests, merges, repository sync, or branch cleanup.
Load when creating, editing, scheduling, running, or debugging dbt jobs and production deployments.
Load when building, editing, running, or debugging dbt models, dbt projects, schema.yml tests, sources, seeds, snapshots, incremental models, materializations, or dbt jobs in the Transforms section.
Load when creating, editing, configuring, validating, or debugging database sync flows, connector flows, pagination, incremental sync, destination mappings, and flow form fields.
Add a new MCP server preset (connector) to Mako's MCP client system — server URL, auth model (OAuth DCR, pre-registered app, or API key), scopes, icon, tests, and docs. Use when connecting a new external MCP server (like Slack or Close CRM) or changing how MCP connections authenticate.
| name | build-desktop-app |
| description | Build, test, package, and release Mako Desktop and the Mako Local Agent. Use when changing packages/desktop, packages/local-agent, shipping a new desktop version, or debugging the desktop release pipeline. |
| Piece | Path | Output |
|---|---|---|
| Local Agent | packages/local-agent | dist/index.js (single-file bundle, plain node) |
| Desktop shell | packages/desktop | release/* (dmg/exe/AppImage via electron-builder) |
| Release pipeline | .github/workflows/release-desktop.yml | GitHub Release desktop-vX.Y.Z |
| PR smoke build | .github/workflows/desktop-ci.yml | build-only |
| Website links | website/lib/downloads.ts, website/app/download | evergreen download page |
pnpm agent:dev # agent on 127.0.0.1:41720
MAKO_DESKTOP_URL=http://localhost:5173 pnpm desktop:dev # shell against dev stack
The shell skips spawning the agent if one is already listening (or set
MAKO_AGENT_SPAWN=0).
pnpm --filter @mako/local-agent typecheck && pnpm --filter @mako/desktop typecheckcurl http://127.0.0.1:41720/health, then /test-connection and /execute
against a local Postgres/Mongo.pnpm --filter @mako/local-agent build && node packages/local-agent/dist/index.jspnpm --filter @mako/desktop pack:dir && packages/desktop/release/linux-unpacked/mako
(use ELECTRON_DISABLE_SANDBOX=1 and DISPLAY=:1 in headless VMs).
Verify the packaged app spawned the bundled agent: curl http://127.0.0.1:41720/health.version in packages/desktop/package.json (semver) in the PR.release-desktop.yml builds macOS arm64+x64, Windows
x64, Linux x64 and creates tag + GitHub Release desktop-vX.Y.Z.force to re-upload.https://github.com/mako-ai/mako/releases/latest/download/Mako-{mac-arm64.dmg,mac-x64.dmg,win-x64.exe,linux-x86_64.AppImage}OPTIONAL_STUBS in packages/local-agent/build.mjs.onlyBuiltDependencies in pnpm-workspace.yaml must include electron
or its binary won't download; the server Dockerfile sets
ELECTRON_SKIP_BINARY_DOWNLOAD=1 to keep images lean.packages/desktop/README.md for the secret names.${arch} to x86_64 for AppImage names.