CLI · Reference

Command reference

23 commands. Run any of them with upg <command> --help for the same options shown here.

Read

Inspect and score the graph. Safe, read-only.

upg health

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

upg verify

Structural validation. Exits 1 on violations for CI gates.

upg diff

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

upg list

Query entities from the graph.

upg tree

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

upg search

Fuzzy text search across titles and descriptions.

Create & edit

Mutate the graph: nodes, edges, and gap-driven scaffolding.

upg create

Create an entity. Type is validated against the spec.

upg update

Update an entity. Unspecified fields are preserved.

upg delete

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

upg connect

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

upg gaps

Report empty domains, broken chains, and sparse areas.

Graph

Create, scope, and move whole graphs in and out of the .upg format.

upg init

Create a .upg file. Interactive by default.

upg workspace

Workspace actions: list (default), switch <name>, add <title>.

upg import

Pull entities from an external tool into your .upg file.

upg export

Export entities as JSON, Markdown, or CSV.

Cloud

Authenticate and sync graphs with the hosted cloud.

upg login

Authenticate with UPG cloud via browser OAuth or --key.

upg logout

Remove stored credentials.

upg push

Push the local graph to cloud.

upg pull

Pull cloud changes into the local .upg file.

upg products

List your cloud products.

upg log

Recent activity log for a cloud product.

Setup

Wire the CLI and MCP server into your environment.

upg install-skills

Link bundled UPG skills into Claude Code.

upg mcp

Configure, inspect, and run the UPG MCP server.