Memi

Quickstart

Run one audit in any frontend repository:

npx -y @memi-design/cli@2.6.4 diagnose . --json --no-write --fail-on none

You get a score, normalized finding IDs, confidence, provenance, and file:line evidence. No account, API key, Figma file, global install, or daemon is required.

Keep the workflow available to your coding agent:

npx skills add memi-design/memi --skill audit-frontend-design

Then ask:

> Audit this frontend before editing it. Prioritize the five fixes that will matter most to users.

| Focused skill | Use it when | | --- | --- | | audit-frontend-design | Find interface risks before changing UI | | remember-design-system | Load compact product-system context | | enforce-design-ci | Gate pull requests with deterministic evidence | | build-swiftui-interface | Build and verify native Apple interfaces |

Compatible with the shadcn registry and v0 design systems.

If Memi catches a real interface issue in your project, star the repository and share the finding. That is the most useful signal for deciding what to improve next.

What Memi catches

| Signal | Example evidence | | --- | --- | | Accessibility | Missing labels, reduced-motion fallbacks, focus and contrast risks | | Interface craft | Weak hierarchy, spacing drift, brittle responsive behavior | | Product states | Missing loading, empty, error, success, and permission states | | Design systems | Token drift, raw values, inconsistent component usage | | Routes and components | App graph, duplicated patterns, risky change surfaces | | Pull requests | New debt only, SARIF annotations, step summary, HTML report |

The first command is deliberately read-only. Write-capable scaffolds and Figma operations are separate, explicit workflows.

How it works

1. Inspect - build an evidence graph from source, routes, styles, and local design-system files.
2. Find - report normalized issues with severity, confidence, provenance, and file:line.
3. Correct - let a human or coding agent make a scoped change.
4. Verify - rerun the same command and compare the evidence.

No LLM is used in the deterministic CI enforcement path.

Choose your integration

| Surface | Start here | Best for | | --- | --- | --- | | One-time CLI audit | npx -y @memi-design/cli@2.6.4 diagnose . --no-write | Trying Memi without installing | | Global CLI | npm i -g @memi-design/cli | Daily local use | | Agent Skill | npx skills add memi-design/memi --skill audit-frontend-design | Codex, Claude, Cursor, and compatible agents | | GitHub Action | uses: memi-design/memi@ec4d804220bfbf08be810ceb692a338cf186e794 | Pull-request design CI | | MCP server | memi mcp start --no-figma | Any MCP client | | Studio | brew install --cask memi-design/memi/memi-studio | Supervised macOS workflows |

The CLI and focused skills are primary. Studio, Figma, research, scaffolding, registries, and the larger tool router are deeper paths.

Design CI

Pin the release commit so every pull request runs the same code:

name: design
on: [pull_request]

permissions:
  contents: read

jobs:
  memi:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      security-events: write
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          fetch-depth: 0
      - uses: memi-design/memi@ec4d804220bfbf08be810ceb692a338cf186e794 # v2.6.4
        with:
          version: "2.6.4"
          report: true
          upload-sarif: true

The Action adds code-scanning annotations, a step summary, and a memi-design-health artifact. Existing debt can be baselined while new debt fails the gate.

[GitHub Action guide](docs/GITHUBACTIONMARKETPLACE.md) · [CI recipes](docs/CIRECIPES.md) · [team rollout](docs/TEAMROLLOUT.md)

Agent and MCP setup

Install a complete project kit:

memi agent install codex --project .
memi agent install claude-code --project .
memi agent install cursor --project .
memi agent install grok-build --project .

Start the local MCP server without Figma:

memi mcp start --no-figma

{
  "mcpServers": {
    "memoire": {
      "command": "memi",
      "args": ["mcp", "start", "--no-figma"]
    }
  }
}

Codex plugin marketplace:

codex plugin marketplace add memi-design/memi --ref main --sparse .agents/plugins --sparse plugins/memoire

[Agent stack guide](docs/AGENTSTACKS.md) · [copy-paste recipes](docs/AGENTRECIPES.md) · [full skill router](skills/memoire-design-tooling/SKILL.md)

Proof you can inspect

• design-sandbox - runnable Next.js, Tailwind, shadcn, MCP, and Agent Skills integration.
• [Release gates](docs/RELEASE_GATES.md) - package, provenance, clean install, MCP, plugin, binary, and public-surface checks.
• [Current release truth](docs/CURRENT_RELEASE.md) - one source for npm, GitHub, Action, Studio, and website versions.
• [Audit reports](docs/audits/) - timestamped findings, evidence gaps, score caps, and owners.
• [llms.txt](llms.txt) - compact machine-readable product map.

Trust defaults

• Read-only audit by default
• No npm install-time lifecycle scripts
• No account or API key for the first audit
• No source upload or covert telemetry
• Figma installation and connection are explicit
• Agent kit writes support --dry-run --json
• Immutable Action pins and release provenance
• MIT core with third-party boundaries documented in [NOTICE](NOTICE)

Community

• Ask a question
• Show what Memi found
• Report a bug
• Request a feature
• [Contribute](CONTRIBUTING.md)

Useful contributions include reproducible audit fixtures, framework adapters, skill improvements, accessible UI cases, shader and motion checks, and real before/after reports.

More commands

CLI reference

| Command | What it does | | --- | --- | | memi diagnose [target] | App-quality graph and file-anchored findings | | memi ux audit [target] | UX tenets and product-state risks | | memi craft audit [target] | Hierarchy, rhythm, convention, and responsive critique | | memi tokens --from | Extract tokens, aliases, modes, and drift | | memi agent brief . --json | Compact evidence contract before UI work | | memi scaffold component --json | Dry-run Atomic Design scaffold | | memi ios brief --json | Apple-platform design brief | | memi shadcn export --out public/r | Export a shadcn-compatible registry | | memi research design --json | Research-to-design package | | memi ci | Baseline-aware pull-request gate | | memi mcp start --no-figma | Local MCP server |

Install without npm

curl -fsSL https://memoire.cv/install.sh | sh
brew install memi-design/memi/memoire
docker run --rm -it -v "$PWD:/work" -w /work ghcr.io/memi-design/memi --help

License

Studio interface references and adapted components include Hermes WebUI and the MIT Warp UI framework boundary around warpui_core and warpui; Warp AGPL application and client code is not copied into Memi.

MIT. See [NOTICE](NOTICE) for optional adapters and complete third-party attribution.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: memi-design
• Source: memi-design/memi
• License: MIT
• Homepage: https://memoire.cv

Install and usage instructions live in the source repository linked above.