CLI Reference
devex status & list
Check installation status and browse available applications
devex status & list
The status and list commands provide essential information about your development environment. Use status to check what's installed and working, and list to browse available applications and discover new tools.
devex status
Check the installation status of applications in your development environment.
Usage
devex status [flags]Options
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--format | -f | string | table | Output format (table, json, yaml, csv) |
--category | -c | string | all | Filter by category |
--verbose | -v | bool | false | Show detailed information |
--check-updates | -u | bool | false | Check for available updates |
--problems-only | -p | bool | false | Show only problematic installations |
Basic Status Output
devex status
Installation Status:
┌─────────────────┬─────────┬─────────────┬─────────────┬──────────────────┐
│ Application │ Status │ Method │ Version │ Last Updated │
├─────────────────┼─────────┼─────────────┼─────────────┼──────────────────┤
│ git │ ✓ │ apt │ 2.39.2 │ 2024-08-15 │
│ docker │ ✓ │ apt │ 24.0.5 │ 2024-08-17 │
│ node │ ✓ │ mise │ 20.5.1 │ 2024-08-17 │
│ python │ ✓ │ mise │ 3.11.4 │ 2024-08-16 │
│ vscode │ ✓ │ apt │ 1.91.1 │ 2024-08-17 │
│ postgresql │ ⚠ │ apt │ 14.8 │ 2024-08-10 │
│ slack │ ✗ │ flatpak │ - │ Never │
└─────────────────┴─────────┴─────────────┴─────────────┴──────────────────┘
Summary: 5 installed, 1 warning, 1 not installedStatus Categories
✓ Installed
Application is installed and working correctly
⚠ Warning
Application is installed but has issues (service not running, misconfigured, etc.)
✗ Not Installed
Application is configured but not installed
? Unknown
Cannot determine installation status
Category-Specific Status
# Check development tools only
devex status --category development
# Check databases only
devex status --category databases
# Check programming languages
devex status --category environment
# Check optional applications
devex status --category optionalUpdate Checking
# Check for application updates
devex status --check-updates
# Shows available updates:
# ┌─────────────────┬─────────────┬─────────────┬──────────────┐
# │ Application │ Current │ Available │ Update Type │
# ├─────────────────┼─────────────┼─────────────┼──────────────┤
# │ node │ 20.5.1 │ 20.6.0 │ Minor │
# │ docker │ 24.0.5 │ 24.0.6 │ Patch │
# │ vscode │ 1.91.1 │ 1.92.0 │ Minor │
# └─────────────────┴─────────────┴─────────────┴──────────────┘devex list
Browse and discover available applications that can be installed with DevEx.
Usage
devex list [flags]Options
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--category | -c | string | all | Filter by category |
--search | -s | string | Search by name or description | |
--installed | -i | bool | false | Show only installed applications |
--available | -a | bool | false | Show only available (not installed) applications |
--format | -f | string | table | Output format (table, json, yaml, list) |
--platform | -p | string | auto | Filter by platform (linux, macos, windows) |
--detailed | -d | bool | false | Show detailed information |
Basic Listing
devex list
Available Applications:
┌─────────────────┬─────────────────────┬─────────────────────┬──────────┐
│ Name │ Description │ Category │ Status │
├─────────────────┼─────────────────────┼─────────────────────┼──────────┤
│ git │ Version control │ Development Tools │ ✓ │
│ docker │ Container platform │ Development Tools │ ✓ │
│ vscode │ Code editor │ Development Tools │ ✓ │
│ node │ JavaScript runtime │ Programming Lang. │ ✓ │
│ python │ Python runtime │ Programming Lang. │ ✓ │
│ postgresql │ SQL database │ Databases │ ⚠ │
│ mysql │ SQL database │ Databases │ ✗ │
│ redis │ In-memory store │ Databases │ ✗ │
│ slack │ Team communication │ Optional │ ✗ │
│ chrome │ Web browser │ Optional │ ✗ │
└─────────────────┴─────────────────────┴─────────────────────┴──────────┘
Total: 247 applications (5 installed, 1 warning, 241 available)Detailed Application Information
devex list --detailed docker
Docker - Container platform for developers
┌─────────────────────┬─────────────────────────────────────────┐
│ Category │ Development Tools │
│ Default Install │ Yes │
│ Status │ ✓ Installed │
│ Version │ 24.0.5 │
│ Platform Support │ Linux, macOS, Windows │
├─────────────────────┼─────────────────────────────────────────┤
│ Linux Install │ apt (official repository) │
│ Dependencies │ curl, gnupg │
│ Post-install │ Add user to docker group │
│ Service │ systemd (docker.service) │
├─────────────────────┼─────────────────────────────────────────┤
│ macOS Install │ brew cask │
│ Alternative │ Docker Desktop │
├─────────────────────┼─────────────────────────────────────────┤
│ Windows Install │ winget │
│ Alternative │ Docker Desktop, chocolatey │
└─────────────────────┴─────────────────────────────────────────┘
Description:
Docker enables you to separate your applications from your infrastructure
so you can deliver software quickly. Docker provides the ability to package
and run an application in a loosely isolated environment called a container.Filter Options
# Show only installed applications
devex list --installed
# Show only available (not installed) applications
devex list --available
# Show applications with warnings
devex list --problems-onlydevex detect
Detect and display information about your current platform and environment.
Usage
devex detect [flags]Options
| Flag | Type | Default | Description |
|---|---|---|---|
--verbose | bool | false | Show detailed detection information |
--format | string | table | Output format (table, json, yaml) |
Platform Detection Output
devex detect
Platform Information:
┌─────────────────────┬─────────────────────────────────┐
│ Operating System │ Linux │
│ Distribution │ Ubuntu 22.04 LTS │
│ Architecture │ x86_64 │
│ Desktop Environment │ GNOME 42.9 │
│ Shell │ zsh 5.8.1 │
│ Terminal │ gnome-terminal │
└─────────────────────┴─────────────────────────────────┘
Package Managers:
✓ apt (primary)
✓ flatpak
✓ snap
✓ mise (for languages)
Recommendations:
→ Primary installer: apt
→ Universal packages: flatpak
→ Programming languages: miseOutput Formats
All commands support multiple output formats for integration with other tools:
Human-readable table format with colors and symbols:
devex status
# ┌─────────────────┬─────────┬─────────────┐
# │ Application │ Status │ Method │
# ├─────────────────┼─────────┼─────────────┤
# │ git │ ✓ │ apt │Integration Examples
Scripting with Status Commands
#!/bin/bash
# Check if required tools are installed
required_apps=("git" "docker" "node")
missing_apps=()
for app in "${required_apps[@]}"; do
if ! devex status --format json | jq -r ".applications[] | select(.name == \"$app\" and .status == \"installed\") | .name" | grep -q "$app"; then
missing_apps+=("$app")
fi
done
if [ ${#missing_apps[@]} -ne 0 ]; then
echo "Missing required applications: ${missing_apps[*]}"
echo "Installing missing applications..."
devex add "${missing_apps[@]}" --install
fiMonitoring and Alerting
# Check for problems and send alerts
problems=$(devex status --problems-only --format json)
if [ "$problems" != "[]" ]; then
echo "$problems" | mail -s "DevEx Issues Detected" admin@company.com
fi
# Check for updates weekly
if [ "$(date +%u)" -eq 1 ]; then # Monday
updates=$(devex status --check-updates --format json)
if [ "$updates" != "[]" ]; then
echo "Updates available: $updates"
fi
fiRelated Commands
devex install- Install applications shown in listdevex add- Add applications from list to configurationdevex recovery- Fix issues found in statusdevex config- Manage application configurations
Use devex status regularly to monitor your environment health, and devex list to discover new tools that could improve your workflow.