---
name: govern
description: mokata · See the governed state — rules, memory-by-kind, read/write ratio, pending proposals (read-only).
when_to_use: Engage when the user wants to see the governed state (active rules, memory by kind, the read/write ratio, or pending self-healing proposals), when they ask what mokata is currently enforcing or remembering, or when reviewing governance before a decision. Do NOT engage to change a rule or memory from the view — it is read-only and edits go through the gated memory path — or to run a pipeline phase.
argument-hint: ""
allowed-tools: mcp__mokata__govern, Bash, Read
---

# mokata · govern (a clickable view of the governed state)

A **self-contained**, read-only view of what mokata is governing: the always-on **rules**
tier (rules + guardrails, budget-capped), **memory grouped by kind**, the **read/write
ratio**, and any **pending self-healing proposals**. Same engine and constraints as `watch`
(inline CSS, no network/server/assets, under gitignored `.mokata/temp_local/`). It **surfaces**
the gated `mokata memory edit` manage path for each item — it never writes from the view.

## How to run

**Prefer the MCP tool** (server `mokata`):

- Call the **`govern`** tool. It writes the governance HTML and returns its `path` plus a
  structured summary (`version`, `profile`, `rules`, `reads`/`writes`/`ratio`, `proposals`).
  Tell the user the dashboard was written, give the path to open, and summarize the counts —
  especially any **pending proposals** that need a decision.

**CLI fallback** — resolve the bundled engine (read `~/.mokata/plugin-root` → `ROOT`, or a
`mokata` CLI on PATH), then:

```bash
PY="$(command -v python3 || command -v python)"
ENGINE="PYTHONPATH=\"$ROOT/src\" \"$PY\" -m mokata"
eval "$ENGINE govern --path ."                 # write the governance dashboard (add --open)
```

It is **read-only** and degrades clean (no/empty memory → an empty view). To act on a
proposal, use the **human-gated** `mokata memory edit` (or `/mokata:onboard`) — never from the
dashboard.
