Expand description
§proc - Semantic Process Management CLI
Semantic CLI tool for process management. Target by port, PID, name or path.
§Features
- Unified Targets:
:port,PID, andnamework the same everywhere - Multi-Target:
proc kill :3000,:8080,node- comma-separated targets - Query Language:
proc by node --in .- composable filters - Terminal-Adaptive Tables: Tables adjust to terminal width automatically
- Consistent Filters:
--in,--by,--min-uptime,--parent,--range,--sort,--limit - File Lookup:
proc for ./script.py- find by file path - Cross-Platform: macOS, Linux, and Windows
- Shell Completions: bash, zsh, fish via
proc completions - Man Pages:
proc manpagegenerates documentation
§Quick Start
# What's on port 3000?
proc on :3000
# What's running this file?
proc for ./script.py
# Kill multiple targets
proc kill :3000,:8080,node -y
# Node processes in current directory
proc by node --in .
# Preview before killing
proc kill node --dry-run
# Kill only node processes in current directory
proc kill node --in .
# Generate shell completions
proc completions zsh > ~/.zsh/completions/_proc§Commands
Discovery: on, for, by, in, list, info, ports, tree, stuck
Lifecycle: kill, stop, unstick
Tooling: completions, manpage
Re-exports§
Modules§
- commands
- CLI command implementations
- core
- Core abstractions for process and port management
- error
- Error types for proc CLI
- ui
- User interface components for proc CLI
Constants§
- VERSION
- Library version