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

from @unified-product-graph/cli · Graph

upg import

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

Usage

upg import --from <tool> [path] [options]

Arguments

[path]
For markdown: path to a .md file or directory. Same as --input.

Options

--from <tool>
markdown | notion | linear | vistaly | dovetail | github (required)
--input <path>
For markdown: path to .md file or directory. Defaults to .
--file <path>
Alias for --input (kept for back-compat)
--output <path>
Output .upg path. Defaults to auto-discover or ./product.upg
--dry-run
Preview entities. Skips the write
--yes
Skip confirmation prompts

Examples

Import a directory of Markdown notes

upg import --from markdown --input ./research/ --yes

Output


  Found 12 files  ·  34 entities

  Preview  ·  34 entities · 28 edges

    research_insight        14  ······························
    opportunity              9  ·········
    persona                  6  ······
    feature                  5  ·····

  ✓  Updated product.upg  +34 nodes · +28 edges

  Run upg health to check your graph.

Preview a Linear import without writing

upg import --from linear --dry-run

Import from Notion, skipping prompts

upg import --from notion --yes

Related

upg initupg exportupg workspace