vis check
Check for outdated dependencies in workspace catalogs
vis check
Check for outdated dependencies in workspace catalogs. Only supported for pnpm or bun workspaces with catalogs.
Alias: vis c
Usage
vis check [packages] [options]Examples
vis check # Check all catalog dependencies
vis check react # Check specific packages
vis check --target minor # Only show minor/patch updates
vis check --exclude '@types/*' # Exclude packages by pattern
vis check --security # Include security vulnerability info
vis check --format json # Machine-readable output
vis check --exit-code # Exit 1 if outdated (for CI)Options
| Option | Alias | Default | Description |
|---|---|---|---|
--target | -t | latest | Update target: latest, minor, or patch |
--include | Glob pattern to include packages (repeatable) | ||
--exclude | Glob pattern to exclude packages (repeatable) | ||
--prerelease | false | Include prerelease versions | |
--security | false | Check for known security vulnerabilities (OSV.dev) | |
--format | table | Output format: table, json, or minimal | |
--exit-code | false | Exit with code 1 if outdated dependencies found (CI) |
Output Formats
Table (default)
Displays a color-coded table showing package name, catalog, current version, target version, and update type (patch/minor/major).
JSON
Machine-readable JSON output including both outdated entries and any packages that failed to fetch:
{
"failed": [],
"outdated": [
{
"packageName": "typescript",
"catalog": "default",
"currentVersion": "5.3.0",
"targetVersion": "5.7.0",
"updateType": "minor"
}
]
}Minimal
Compact one-line-per-package output, suitable for scripting.
Configuration Defaults
Set defaults in vis.json to avoid repeating options:
{
"update": {
"target": "minor",
"exclude": ["legacy-*", "deprecated-*"]
}
}CI Usage
Use --exit-code to fail CI when outdated dependencies are found:
- name: Check dependencies
run: vis check --exit-code --format json > deps-report.json