Graph Relationships

Use Graph Commands To Understand Relationships

A tree shows where a bookmark or folder lives. A graph shows how saved items relate. Graph commands are useful for competitor research, knowledge maps, launch planning, and agent workflows that need to explain why items are connected.

Inspect Nearby Relationships

webcull graph around --stack-id 2301 --depth 1 --limit 50 --fields id,parent_id,type,title,url

{
  "success": "true",
  "command": "graph around",
  "stack_id": 2301,
  "direction": "both",
  "depth": 1,
  "nodes": [
    {
      "id": 2000,
      "parent_id": 0,
      "type": "folder",
      "title": "Marketing",
      "url": "",
      "depth": 1
    },
    {
      "id": 2301,
      "parent_id": 2000,
      "type": "folder",
      "title": "Competitors",
      "url": "",
      "depth": 0
    },
    {
      "id": 2302,
      "parent_id": 2301,
      "type": "bookmark",
      "title": "Acme pricing",
      "url": "https://acme.example/pricing",
      "depth": 1
    }
  ],
  "edges": [
    {
      "from": 2000,
      "to": 2301,
      "type": "contains",
      "source": "hierarchy"
    },
    {
      "from": 2301,
      "to": 2302,
      "type": "contains",
      "source": "hierarchy"
    }
  ],
  "returned_nodes": 3,
  "returned_edges": 2,
  "truncated": false
}

Ask What Points Here Or How Two Items Connect

webcull graph backlinks --stack-id 2302
webcull graph path --from-stack-id 2000 --to-stack-id 2302 --max-depth 4

{
  "success": "true",
  "command": "graph path",
  "from_stack_id": 2000,
  "to_stack_id": 2302,
  "found": "true",
  "max_depth": 4,
  "visited_node_count": 3,
  "path_stack_ids": [2000, 2301, 2302],
  "nodes": [
    {
      "id": 2000,
      "type": "folder",
      "title": "Marketing",
      "depth": 0
    },
    {
      "id": 2301,
      "type": "folder",
      "title": "Competitors",
      "depth": 1
    },
    {
      "id": 2302,
      "type": "bookmark",
      "title": "Acme pricing",
      "depth": 2
    }
  ],
  "edges": [
    {
      "from": 2000,
      "to": 2301,
      "type": "contains",
      "source": "hierarchy"
    },
    {
      "from": 2301,
      "to": 2302,
      "type": "contains",
      "source": "hierarchy"
    }
  ],
  "truncated": false
}

Use backlinks when you need to know what points at an item. Use path when you need to explain how two saved items are connected.

Check Graph Output Before Building On It

webcull graph validate --stack-id 2301
webcull graph schema

Use graph schema when a script needs to understand graph output. Use graph validate when you want to check whether a relationship area is complete or limited by your command options.