Command reference

Set the sticky operating lens (scopes vocabulary). No arg shows the current lens.

Show where the cursor stands (the current node) and the active lens.

Move the cursor to a node (resolved by id or title).

List the cursor's neighbours, grouped by relationship, with a "next here" hint.

Fuzzy search; on a TTY, pick a result to move the cursor there.

Create a node and auto-link it to the cursor (edge + direction inferred).

Connect two nodes; edge type + direction inferred (auto-flips to canonical).

One ranked verdict: structure + health + gaps + anti-patterns. Exit 2 on violations.

Execute the top auto-remediable fix from `upg check` (with confirmation).

Score the graph 0–100. Gate CI with --min-score.

Structural validation. Exits 2 on violations for CI gates.

Compare the current .upg against a git ref. For PR reviews.

Query entities from the graph.

Tree view of the graph. Filter by entity type or domain.

Fuzzy text search across titles and descriptions.

Traverse the graph following typed edges, with field projection and truncation. The BFS primitive behind tree views.

Browse the UPG spec catalogue offline. No graph needed.

Browse the curated starter templates (the library /upg-new-from-template and the site gallery use).

A lens-aware product summary: counts, key entities, and domain guidance.

The recent mutation feed for the graph (create / update / delete).

Create an entity. Type is validated against the spec.

Update an entity. Unspecified fields are preserved.

Delete an entity and its edges. Omit ID for an interactive picker.

Create an edge between 2 nodes. Type is auto-inferred.

Report empty domains, broken chains, and sparse areas.

Re-parent a node under a new parent, re-typing its containment edge.

Remove a single edge by id (the inverse of connect).

Find and merge duplicate nodes (same type + title). Dry-run by default; --apply to commit.

Atomic batch operations: create, update, or delete many entities in one call.

Run a framework over entities: creates a framework_exercise + an includes edge to each.

Record a framework's result for one entity on the exercise's includes edge.

Show a framework exercise: each included entity + the scores recorded on its edge, as a table.

Rank entities by a scoring framework (RICE, ICE, WSJF, value-vs-effort). Read-only. --framework and at least one id are required.

Create a .upg file. Interactive by default.

Workspace actions: list (default), switch <name>, rekind --kind <kind> <file...>.

Import product knowledge from Markdown, Notion, Linear, Vistaly, Dovetail, or GitHub.

Export entities as JSON, Markdown, or CSV.

Rewrite .upg files to canonical form (byte-stable, diff-friendly).

Catalogue-aware migrations: retype a node (applies spec defaults), migrate statuses/properties to current, or rename an edge type. Pairs with fmt and fix.

The canonical-entity registry: shared entities many products instance. Operates on a portfolio graph (default portfolio.upg).

Cross-product and portfolio operations: membership, cross-product edges, classification cells, a portfolio digest, and validation including portfolio anti-patterns.

Product areas within a portfolio: the area hierarchy, area-scoped subgraphs, product membership, and audience links.

Scaffold a structure from a template product, optionally scoped to a region.

Edit product-level fields (title, description, stage, member_kind).

Report local sync state vs the cloud (read-only; push/pull stay agent-only).

Link bundled UPG skills into Claude Code.

Configure, inspect, and run the UPG MCP server.