Skip to content
UPG is in early alpha. The specification is still evolving and may change between versions.

from @unified-product-graph/cli · Stand in the graph

upg new

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

Usage

upg new <type> <title> [options]

Arguments

<type>
Entity type, validated against the UPG spec
<title>
Title for the new node

Options

--file <path>
Path to .upg file
--at <id>
Link to this node instead of the cursor (stateless)
--as <verb|n>
Pick the relationship on an ambiguous pair (verb or 1-based index)
--status <status>
Lifecycle status
--json
Machine-readable JSON output

Examples

Create under the cursor; the catalog infers the edge + direction

upg new solution "Guest checkout flow"

Output

✓ solution "Guest checkout flow" created and linked: opportunity —addresses→ solution

Link to a specific node instead of the cursor

upg new feature "Dark mode" --at n_abc123

Disambiguate the relationship on a piped (non-TTY) run

upg new metric "Cart conversion" --as 2

Related

upg linkupg createupg ls