English
Download for Mac · Run it locally · How a build works · Quickstart
Mish! (formerly Mishh Mashh) is the design workspace ZeroSum Solutions uses to deliver client work. You write a brief. An AI agent on your own machine makes the design. The result stays in a project where you preview it, edit it, and share it.
Apple Silicon Macs can install a ready-made build. No clone or Node needed.
-
Open the latest release and download
Mish-<version>-mac-arm64.dmg. Check it againstSHA256SUMSif you like. -
Open the dmg and drag the app to Applications.
-
The build is not signed by Apple, so macOS blocks the first launch. Right-click the app, choose Open, then Open again. Or run:
xattr -dr com.apple.quarantine "/Applications/Mishh Mashh.app"
You also need an agent CLI such as claude or codex on your PATH; the app uses it to run builds. Apps started from Finder do not always see your shell PATH. If the app cannot find your CLI, start it from Terminal with open -a "Mishh Mashh". A .zip of the same build is on the release page too. Releases are cut by tagging v* (workflow release-mac).
| Part | What it gives you |
|---|---|
Web app (apps/web) |
Home, where you write a brief and choose the kind of output. Projects, where you review, edit and share results. |
Daemon (apps/daemon) |
Runs the agents on your machine, keeps projects and files, and serves the od command line. |
| Agency build | Turns a client brief into a checked website page. This is the part ZeroSum added. |
| Local agents | Uses the agent CLI you already have (Claude Code, Codex, Gemini and others). When one is installed and signed in, it is the first choice on the welcome screen. |
Home offers prototypes, slide decks, images, documents, website clones, video and audio. The composer's Improve prompt button rewrites a short prompt into a structured brief before you run it. It needs either an OpenRouter key with Settings → Labs → Faster Improve prompt on (the default) or a signed-in Claude Code CLI.
Home: choose the kind of output, write the brief, then pick a design system and a working directory.
More about Home and project chat
Project chat supports explicit workspace context; see composer workspace context for folder access and queued draft behavior.
Home remembers the project owner, type, sort order and Archived toggle in this browser for each workspace member and project collection. Local mode keeps a separate set of preferences for each collection. Clear filters keeps the chosen sort order. If browser storage is unavailable, the controls still work for the current visit. Escape closes a slide deck opened in a new tab.
Licensed and third-party content (paid component kits, reference studies, scraped catalogues, fan art) is not in this repository. It is installed separately as private packs through the pack system (docs/packs.md). Features that depend on that content show as unavailable until a pack is installed.
- Brief. Give the client brief inline or from a file.
- Route. One Jev (TypeSafe) request places the brief on the Website Shape Atlas and picks a family package. If no family fits, the build stops and says why. It does not guess.
- Fill. DeepSeek (default) or Cerebras fills the family's typed content slots. A trusted compiler turns the slots into HTML. The model does not write layout or CSS.
- Verify. Jev checks each fact against the brief. In
strictmode (the default) nothing is published if a fact is invented, too long, or missing. - Publish. The page becomes a project. Preview it, edit the text, and share it to Vercel.
Start a build from Design index → Route → Build, or from the CLI:
pnpm exec od agency route --brief "A family dental practice in Riverbend" # route only
pnpm exec od agency build --brief "A family dental practice in Riverbend" --name "Riverbend Dental" # full build
pnpm exec od agency build --from "$BUILD_ID" # rebuild from a saved build; set BUILD_ID firstRouting and verification need a Jev key: od agency config set --key-stdin. od agency --help lists every flag and exit code. Details: packages/agency-fast-lane/README.md and docs/agency-site.md.
New teammates: run sh scripts/team-setup.sh. It checks prerequisites, installs, builds and starts the web app in one command. See QUICKSTART.md → Team setup.
You need Node ~24 and pnpm 10.33.2 (Corepack picks the pinned pnpm).
corepack pnpm install
pnpm tools-dev start web --daemon-port 7456 --web-port 3000Open http://127.0.0.1:3000. QUICKSTART.md covers other setups.
Updated 2026-10-12.
| Area | State |
|---|---|
| Languages | English only. |
| Design systems | One: Neutral Product, our own. It is the default. Its status is candidate, not promoted: the checks in QUALITY-STANDARD.md found work left to do. The five brand-copied systems from upstream were removed. |
| Agency build | Works end to end: route, fill, verify, publish. Twelve bundled families in three page kinds: ten site families, one app (app shell) and one dashboard (CRM dashboard). od agency families lists them. |
| Desktop app | Not ready to give to anyone. See Limits. |
| CI | GitHub Actions on GitHub-hosted runners validates pull requests. |
- A desktop build must not go to anyone yet. The open items are in
docs/legal/LICENSE-COMPLIANCE.md: license files in the installer, the closed-licensevelaCLI, the installer name, and the upstream cloud sign-in card. - Workspace packages use the
@mish/*scope. Theodcommand and theOD_*variables keep their upstream names for compatibility, and parts of the UI still show the earlier name Mishh Mashh. - The web app can be deployed to Vercel from the root
vercel.json, but that deploy is a static UI shell only: there is no daemon behind it, so every/api/*call fails and projects, agents and generation do not work there. SeeQUICKSTART.md→ Deploy the web UI to Vercel.
Repository map
| Path | What it holds |
|---|---|
apps/web |
The Next.js web app |
apps/daemon |
The local daemon, the /api/* routes and the od CLI |
apps/desktop, apps/packaged |
The Electron shell and the packaged runtime |
packages/agency-fast-lane |
The agency build: route, fill, verify |
packages/contracts |
Types shared by the web app and the daemon |
plugins/_official/ |
Bundled plugins, including the agency family packages |
design-systems/ |
Design-system packages (Neutral Product) and their schema |
design-templates/, skills/ |
Render templates and agent skills |
tools/dev, tools/pack |
The local lifecycle and packaged builds |
e2e/ |
End-to-end and Playwright UI tests |
Documentation
| Read this | When |
|---|---|
AGENTS.md |
Before you change code. It is the source of truth for boundaries, commands and checks. |
CONTRIBUTING.md |
Before your first pull request. |
CONTEXT.md |
To learn the domain words. |
docs/architecture.md |
To understand how the parts connect. |
docs/design-systems/QUALITY-STANDARD.md |
Before you add or change a design system. |
docs/FORK-PIN.md |
Before you take a change from upstream. |
docs/legal/LICENSE-COMPLIANCE.md |
Before you give a build to anyone. |
docs/deployment/vercel.md |
Before you deploy a project page to Vercel, or this repository's web UI. |
PRIVACY.md |
To see what data the app sends and when. |
docs/testing/diagnostics-environment.md |
Before saving or sharing a diagnostics bundle; local download, redaction and collection limits. |
TRANSLATIONS.md |
Before you add or change UI text. |
- Fork policy. This is a hard-pinned, cherry-pick-only fork of upstream commit
73953213a(release v0.22.2). We take single upstream commits, never merges. Each one is logged indocs/FORK-PIN.md. - Changes. Every change goes through a pull request with green CI and is squash-merged. Details are in
CONTRIBUTING.md. - UI text. Every new key needs English.
Mish! is a modified version of an upstream project licensed under the Apache License 2.0. See LICENSE and NOTICE. ZeroSum Solutions changed the product name, removed upstream community links, removed brand-copied design systems, ships English only, and turned off most upstream network calls (the rest are listed in LICENSE-COMPLIANCE.md). This repository starts from a snapshot of ZeroSum's private working repository; see NOTICE.

