intent-list.md

title	intent list
id	intent-list

intent list discovers skill-enabled packages and prints available skills.

npx @tanstack/intent@latest list [--json]

Options

• --json: print JSON instead of text output

What you get

• Scans project and workspace dependencies for intent-enabled packages and skills
• Intentionally includes accessible global packages when listing installed skills
• Includes warnings from discovery
• If no packages are discovered, prints No intent-enabled packages found.
• Summary line with package count, skill count, and detected package manager
• Package table columns: PACKAGE, SOURCE, VERSION, SKILLS, REQUIRES
• Skill tree grouped by package
• Optional warnings section (⚠ ... per warning)

REQUIRES uses intent.requires values joined by , ; empty values render as –. SOURCE is a lightweight indicator showing whether the selected package came from local discovery or explicit global scanning.

JSON output

--json prints the ScanResult object:

{
  "packageManager": "npm | pnpm | yarn | bun | unknown",
  "packages": [
    {
      "name": "string",
      "version": "string",
      "source": "local | global",
      "intent": {
        "version": 1,
        "repo": "string",
        "docs": "string",
        "requires": ["string"]
      },
      "skills": [
        {
          "name": "string",
          "path": "string",
          "description": "string",
          "type": "string (optional)",
          "framework": "string (optional)"
        }
      ]
    }
  ],
  "warnings": ["string"]
}

packages are ordered using intent.requires when possible. When the same package exists both locally and globally, intent list prefers the local package.

Common errors

• Scanner failures are printed as errors
• Unsupported environments:
  • Yarn PnP without node_modules
  • Deno projects without node_modules