# memi — @memi-design/cli

Interface understanding for AI coding agents. Design-system memory for coding agents.
npm: https://www.npmjs.com/package/@memi-design/cli
MCP registry: io.github.sarveshsea/memi
GitHub: https://github.com/sarveshsea/memi
Proof: https://github.com/sarveshsea/design-sandbox
Craft skills (upstream): https://github.com/emilkowalski/skills

## Install

```bash
npm i -g @memi-design/cli
```

## Before any UI work

```bash
memi agent brief . --intent "<task>" --detail compact --json
memi diagnose . --json
memi ux audit . --json
memi craft audit . --json
memi tokens --from ./src --report
memi scaffold component <Name> --level organism --json
memi ios brief --intent "<SwiftUI task>" --detail compact --json
memi ios scaffold <Name> --kind screen --module <AppModule> --json
memi shadcn export --out public/r
```

## Grok Build (Grok 4.5) — primary stack

```bash
memi agent install grok-build --project .
grok inspect
grok mcp doctor memoire
memi agent brief . --agent grok-build --intent "<task>" --json
```

Writes: `.grok/config.toml` (MCP), `.grok/skills/memoire-design-tooling/`, `.agents/skills/memoire-design-tooling/` (mirror), `memoire.agent.yaml`.

Manual MCP: `grok mcp add memoire --scope project -- memi mcp start --no-figma`

## Other agent stacks

```bash
memi agent install universal --project .
memi agent install cursor --project .
memi agent install claude-code --project .
memi agent install codex
memi agent install codex-plugin
memi agent install hermes
memi agent install openclaw --project .
memi agent install opencode --project .
npx skills add sarveshsea/memi --skill memoire-design-tooling
npx skills add emilkowalski/skills
```

## MCP server

```bash
memi mcp start --no-figma
```

Key tools: prepare_design_agent_brief, prepare_apple_design_brief, scaffold_agent_design_files, scaffold_swiftui_files, diagnose_app_quality, audit_ux_tenets_traps, audit_interface_craft, get_tokens, get_shadcn_registry, plan_ui_fixes, design_doc, research_design_package, simulation_plan, simulation_run, check_bridge_health.

## Design CI gate

```bash
memi init --team
memi ci
```

GitHub Action: `uses: sarveshsea/memi@v2` with `version: "2.5.0"`.

## Dependency graph

- memi CLI/MCP ↔ agent kits ↔ Action ↔ design-sandbox (proof)
- memi skills ↔ skills.sh (`npx skills add sarveshsea/memi`)
- craft polish ↔ emilkowalski/skills (reference, not bundled)

## Agent policy

- Run memi before broad UI edits.
- Prefer evidence from diagnose, ux audit, craft audit, tokens, and MCP tools over visual guessing.
- Use shadcn/ui primitives and Tailwind tokens; avoid raw one-off colors.
- Classify UI changes by Atomic Design level.
- Cite verification commands in the handoff.
- No LLM in the CI enforcement path — findings are deterministic and cite file:line.