Skip to content

from @unified-product-graph/cli · Graph

upg import

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

Usage

upg import --from <tool> [options]

Options

--from <tool>
Source tool: markdown, notion, linear, github, vistaly, dovetail, jira (required)
--file <path>
For markdown: path to .md file or directory. Defaults to .
--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 --file ./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