{
  "markdown": "<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/memi-design/memi/main/assets/memi-brand-banner.png\" alt=\"Memi — the design layer for agentic AI.\" width=\"100%\" />\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@memi-design/cli\"><img src=\"https://img.shields.io/npm/v/@memi-design/cli?color=bd3f63&label=npm\" alt=\"npm version\"></a>\n  <a href=\"https://www.npmjs.com/package/@memi-design/cli\"><img src=\"https://img.shields.io/npm/dw/@memi-design/cli?color=171718&label=weekly%20downloads\" alt=\"weekly npm downloads\"></a>\n  <a href=\"https://github.com/memi-design/memi/actions/workflows/ci.yml\"><img src=\"https://github.com/memi-design/memi/actions/workflows/ci.yml/badge.svg?branch=main\" alt=\"CI\"></a>\n  <a href=\"https://github.com/memi-design/memi/stargazers\"><img src=\"https://img.shields.io/github/stars/memi-design/memi?style=social\" alt=\"GitHub stars\"></a>\n  <a href=\"https://github.com/memi-design/memi/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-171718.svg\" alt=\"MIT license\"></a>\n</p>\n\n# Memi\n\n**The design layer for agentic AI.**\n\nGive your coding agent an interface brief before it edits. Memi maps the UI already in your repository, surfaces file-anchored accessibility and design-system risks, and gives you a deterministic check to rerun before merge. Start with the CLI, then add the same gate to every pull request.\n\nMemi Studio is available today; Memi Canvas is currently in development. No account, API key, Figma file, global install, or daemon is required for the first audit.\n\n<p align=\"center\">\n  <a href=\"#quickstart\"><strong>Start with your next interface</strong></a> ·\n  <a href=\"https://memoire.cv/download\">Get Memi Studio</a> ·\n  <a href=\"#research-and-benchmarks\">Read the research</a>\n</p>\n\n## Quickstart: find your first interface issue\n\nRun one non-destructive audit in any frontend repository. It needs no account, API key, Figma file, global install, or daemon.\n\n```bash\nnpx -y @memi-design/cli@latest diagnose . --json --no-write --fail-on none\n```\n\nThe result carries normalized finding IDs, confidence, provenance, and `file:line` evidence so an agent can act on a specific finding instead of guessing.\n\nGive the same context to your coding agent:\n\n```bash\nnpx skills add memi-design/memi --skill audit-frontend-design\n```\n\nThen ask:\n\n> Audit this frontend before editing it. Prioritize the five changes that will matter most to users, reuse the existing system, and verify the result after the patch.\n\nIf Memi catches a real interface issue in your project, [share the finding](https://github.com/memi-design/memi/discussions/categories/show-and-tell). Real reports are the most useful signal for what to improve next.\n\n## Put the check on every pull request\n\nCopy [`examples/github-actions/memi-design.yml`](examples/github-actions/memi-design.yml) into your repository as `.github/workflows/memi-design.yml`. The starter is pinned to the reviewed public Action commit and gives reviewers:\n\n- a PR check that fails only on newly introduced interface debt;\n- a `memi-design-health` artifact with the human-readable report; and\n- SARIF annotations when the repository grants `security-events: write`.\n\nThe workflow does not need an API key or a Memi secret. Fork pull requests still receive the check and report; SARIF upload is skipped automatically when GitHub does not grant that permission.\n\nIf you prefer to configure it by hand, the complete [GitHub Action guide](https://github.com/memi-design/memi/blob/main/docs/GITHUB_ACTION_MARKETPLACE.md) documents every input, output, permission, and evidence file.\n\n## One product layer, three surfaces\n\n| Surface | What it is | Status |\n| --- | --- | --- |\n| **Memi CLI** | Interface intelligence and deterministic checks for local repositories, agents, and CI. | Available today |\n| **Memi Studio** | A macOS workbench for bringing project context, agent workflows, and verification together. | [Available today](https://memoire.cv/download) |\n| **Memi Canvas** | A visual workspace for design-system context and controlled agent proposals. | currently in development |\n\n## See the product\n\n| Memi Studio | Memi Canvas — in development |\n| --- | --- |\n| <img src=\"https://raw.githubusercontent.com/memi-design/memi/main/product-hunt-assets/source-captures-v2/studio-real-01-workbench.png\" alt=\"Memi Studio workbench showing a project workspace, prompt, and inspector.\" width=\"100%\" /> | <img src=\"https://raw.githubusercontent.com/memi-design/memi/main/assets/product/memi-canvas-workspace.png\" alt=\"Memi Canvas workspace preview showing a design system, proposal run, and verification state.\" width=\"100%\" /> |\n| Bring an agent prompt, project memory, and a verification surface into one workbench. | Preview design-system context, inspect a proposal, and keep a human in the loop. This preview shows an active development build, not a released product guarantee. |\n\n## What Memi adds to an agent workflow\n\n| Before the edit | During the edit | Before merge |\n| --- | --- | --- |\n| Discover components, tokens, routes, states, and accessibility gaps. | Give the agent a scoped brief that names the system it must preserve. | Rerun deterministic checks and surface new interface debt in CI. |\n\n| Need | Start with |\n| --- | --- |\n| Find UI risks and product-system context | `audit-frontend-design` |\n| Plan a change around existing components and tokens | `remember-design-system` |\n| Keep new interface debt out of pull requests | `enforce-design-ci` |\n| Build and verify native Apple interfaces | `build-swiftui-interface` |\n\nCompatible with the [shadcn registry](https://ui.shadcn.com/docs/registry/getting-started) and [v0 design systems](https://v0.app/docs/design-systems).\n\n## Evidence at a glance\n\nThe [V15 confirmatory audit](https://github.com/memi-design/memi/tree/main/docs/research/memi-2.7-prospective-study/v15-2.7.3-confirmatory) is a public technical disclosure, not a leaderboard. It separates receipt admission, rendered design quality, functional acceptance, and resource observations.\n\n| Measured record | Exact reading |\n| --- | --- |\n| 36 / 36 frozen receipts admitted | Every preregistered agent cell had an auditable receipt. This is receipt admission, not universal performance. |\n| **10 complete model-graded matched pairs** | Rendered design-quality comparisons that survived the prespecified screen. This is model-graded evidence, not independent practitioner review. |\n| Buzzr / Expo: mean **+1.4**; Paraform / web: mean **−0.4** | The scoped non-inferiority gate passed on both graded task families. It does not establish general superiority. |\n| **0 / 21** corrected task-by-resource tests rejected | The study did not establish a speed, cost, or token-use advantage. |\n\n**Separate historical release record:** the 2.7 candidate record reported **2,187 / 2,187** tests passed. It is release evidence, not part of V15 and not proof that every project benefits.\n\n## Benchmarks and paper\n\n<p align=\"center\">\n  <a href=\"https://github.com/memi-design/memi/releases/download/v2.7.4/memi-2.7.3-confirmatory-audit.pdf\">\n    <img src=\"https://raw.githubusercontent.com/memi-design/memi/main/assets/readme-benchmark.svg\" alt=\"V15 benchmark preview: scoped quality non-inferiority passed for two task families; the study makes no general superiority, speed, or cost claim.\" width=\"100%\" />\n  </a>\n</p>\n\nQuality non-inferiority passed for the scoped Buzzr and Paraform task families. The full paper reports exclusions, failed paths, and limitations without imputation. **No superiority, speed, or dollar-savings claim is made.** Read the [conference-style audit PDF](https://github.com/memi-design/memi/blob/main/docs/research/memi-2.7-prospective-study/v15-2.7.3-confirmatory/memi-2.7.3-confirmatory-audit.pdf), inspect the [protocol and receipts](https://github.com/memi-design/memi/tree/main/docs/research/memi-2.7-prospective-study/v15-2.7.3-confirmatory), or review the [V17 preregistration](https://github.com/memi-design/memi/blob/main/docs/research/memi-2.7-prospective-study/v17-routing-quality/README.md).\n\n**Memi InterfaceBench v1** is a 100 target tasks specification with 5 pinned seed tasks; it is not an aggregate performance score. The historical candidate record reported 2,187/2,187 tests and 70.57% statements coverage. The greater-than-25% claim remains **not verified**. Inspect the [benchmark contract](https://github.com/memi-design/memi/blob/main/benchmarks/interfacebench-v1.json) and [workflow evidence](https://github.com/memi-design/memi/blob/main/docs/case-studies/memi-2.7-workflow-proof/results.json).\n\n**Memi DesignWorkBench v2** holds 300 task contracts and requires practitioner calibration before any certification claim.\n\n## Prompts that map to real workflows\n\n| Goal | Copy-paste prompt | Supporting workflow |\n| --- | --- | --- |\n| Establish a baseline before a UI change | **Audit this frontend before editing it.** Prioritize the five changes with the clearest `file:line` evidence. | `audit-frontend-design` |\n| Turn evidence into a scoped plan | **Turn the findings into a scoped UI change plan.** Reuse existing components and tokens before editing. | `remember-design-system` |\n| Protect a pull request | **Set up a deterministic design CI gate for this pull request.** Fail only on newly introduced interface debt and save SARIF plus the HTML report. | `enforce-design-ci` |\n\n## Research, stated plainly\n\nThe research is disclosure material, not a product leaderboard. It keeps functional, rendered-quality, and resource evidence separate so a result cannot be made to say more than the study supports.\n\n## Choose your integration\n\n| Surface | Start here | Best for |\n| --- | --- | --- |\n| One-time CLI run | `npx -y @memi-design/cli@2.7.9 diagnose . --no-write` | Trying Memi without installing |\n| Global CLI | `npm i -g @memi-design/cli` | Daily local use |\n| Agent Skill | `npx skills add memi-design/memi --skill audit-frontend-design` | Codex, Claude Code, Cursor, and compatible agents |\n| GitHub Action | [Copy the starter workflow](examples/github-actions/memi-design.yml) | Pull-request design CI |\n| MCP server | `memi mcp start --no-figma` | Any MCP client |\n| Studio | `brew install --cask memi-design/memi/memi-studio` | Supervised macOS workflows |\n\n### GitHub Action\n\n```yaml\nname: design\non: [pull_request]\n\npermissions:\n  contents: read\n\njobs:\n  memi:\n    runs-on: ubuntu-latest\n    permissions:\n      contents: read\n      security-events: write\n    steps:\n      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1\n        with:\n          fetch-depth: 0\n      - uses: memi-design/memi@5fcbf39e1255af0c14c5a17ba6bde8cf1206e525 # v2.7.9\n        with:\n          version: \"2.7.9\"\n          report: true\n          upload-sarif: true\n```\n\nThe Action adds code-scanning annotations, a step summary, and a `memi-design-health` artifact. Existing debt can be baselined while newly introduced debt fails the gate.\n\n[GitHub Action guide](https://github.com/memi-design/memi/blob/main/docs/GITHUB_ACTION_MARKETPLACE.md) · [CI recipes](https://github.com/memi-design/memi/blob/main/docs/CI_RECIPES.md) · [current versions](https://github.com/memi-design/memi/blob/main/docs/CURRENT_RELEASE.md)\n\n### Agent and MCP setup\n\n```bash\nmemi agent install codex --project .\nmemi agent install claude-code --project .\nmemi agent install cursor --project .\nmemi agent install grok-build --project .\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"memoire\": {\n      \"command\": \"memi\",\n      \"args\": [\"mcp\", \"start\", \"--no-figma\"]\n    }\n  }\n}\n```\n\nCodex plugin marketplace:\n\n```bash\ncodex plugin marketplace add memi-design/memi --ref main --sparse .agents/plugins --sparse plugins/memoire\n```\n\n[Agent stack guide](docs/AGENT_STACKS.md) · [copy-paste recipes](https://github.com/memi-design/memi/blob/main/docs/AGENT_RECIPES.md) · [full skill router](skills/memoire-design-tooling/SKILL.md)\n\n## Trust and proof\n\n- [Release gates](https://github.com/memi-design/memi/blob/main/docs/RELEASE_GATES.md) — package, provenance, clean-install, MCP, plugin, binary, and public-surface checks.\n- [Current release truth](https://github.com/memi-design/memi/blob/main/docs/CURRENT_RELEASE.md) — the public versions for CLI, Studio, and website.\n- [Reproducible case studies](https://github.com/memi-design/memi/tree/main/docs/case-studies) — pinned evidence, abstentions, and paired protocols.\n- [Dependency trust ledger](docs/DEPENDENCY_TRUST.md) — direct dependency purpose, dynamic boundaries, and review policy.\n- [`llms.txt`](llms.txt) — compact machine-readable product map.\n\nMemi has no npm install-time lifecycle scripts, no source upload or covert telemetry, explicit Figma connection, agent-kit `--dry-run --json`, immutable Action pins, and documented third-party boundaries in [NOTICE](NOTICE).\n\n## Community\n\nWe welcome contributions. See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and pull-request guidance. Bugs and feature requests belong in [issues](https://github.com/memi-design/memi/issues); questions and real project reports belong in [Discussions](https://github.com/memi-design/memi/discussions).\n\nUseful contributions include reproducible audit fixtures, framework adapters, skill improvements, accessible UI cases, motion checks, and before/after reports.\n\n## License\n\nStudio 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.\n\nMIT. See [NOTICE](NOTICE) for optional adapters and complete third-party attribution.\n",
  "bytes": 13600,
  "sha": "e99a55ab2bfc434ba0c016c4f9e405e59c8677a654ad6d0c1c4813a9b634530e",
  "repo_slug": "memi-design/memi",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sarveshsea_memi_97c9c5de/readme"
}