VisIntroduction
Introduction
A CLI task runner for monorepo workspaces with task caching, dependency-aware scheduling, catalog management, and git hooks
Visulima Vis
A CLI task runner for monorepo workspaces, powered by @visulima/task-runner and @visulima/cerebro.
Key Features
Task Execution
- Workspace-aware - Automatically discovers projects from
pnpm-workspace.yamlorpackage.jsonworkspaces - Task caching - Local and remote caching powered by
@visulima/task-runner - Dependency-aware scheduling - Runs tasks in topological order with configurable parallelism
- Affected detection - Only runs tasks for projects changed since a given git ref
Dependency Management
- Catalog check - Detect outdated dependencies in pnpm/bun workspace catalogs
- Catalog update - Update catalog entries with automatic backup and rollback
- Security scanning - Check for known vulnerabilities via OSV.dev
- Package manager wrapper - Unified update interface for pnpm, npm, yarn, and bun
Developer Experience
- Graph visualization - View your project dependency graph in ASCII, DOT, JSON, or HTML
- Git hooks - Install, manage, and migrate git hooks (husky migration supported)
- Configurable -
vis.jsonfor target defaults, cache settings, and update preferences - Built on Cerebro - Robust CLI with built-in help, version, and shell completion
Quick Start
# Run a target across all workspace projects
vis run build
# Run tests only on affected projects
vis affected test --base=main
# Check for outdated catalog dependencies
vis check
# Update catalog dependencies interactively
vis update --interactive
# Visualize the project dependency graph
vis graph