Health Checks

Oscar's /check health command runs read-only health checks across your cloud infrastructure, Kubernetes clusters, and version control systems.

Running Health Checks

/check health

Health check execution

What Gets Checked

Oscar automatically discovers and checks:

Cloud Providers:

• AWS (IAM, VPC, Security Groups, EC2, RDS, S3, etc.)

• Azure (Resource Groups, Virtual Networks, Storage, etc.)

• GCP (Projects, VPCs, Compute, Storage, etc.)

Kubernetes:

• Clusters configured in your kubeconfig

• Deployments, services, pods, resource usage

• Security configurations

Version Control:

• GitHub repositories and organizations

• GitLab projects

Custom Checks:

• User-defined health check scripts in ~/.config/oscar/custom-checks/

Interactive Selection

Oscar presents a checkbox interface to select which systems to check. You can:

• Select/deselect individual systems

• Check all systems at once

• Save your selection for next time

Health Check Results

After running checks, Oscar:

1. Collects findings from all selected systems

2. Interprets results with AI

3. Categorizes findings by severity

4. Displays a summary with actionable insights

Results are saved locally and can be:

• Viewed in the terminal

• Assigned to team members with /tasks assign

• Exported as JSON with --write-json flag

Generate Reusable Scripts

/check generate [description]

Creates a standalone health check script you can:

• Add to CI/CD pipelines

• Schedule with cron

• Share with your team

The generated script includes all dependencies and can run on any system with the required cloud CLI tools installed.

Options

/check health --write-json - Save results as JSON file

Saves detailed findings to ~/.config/oscar/health-check-results.json for programmatic access.

Notes

• Health checks are read-only and never modify your infrastructure

• Requires valid cloud credentials (configured via /setup or environment variables)

• Results are stored locally in ~/.config/oscar/

• Each finding has a unique ID for task assignment tracking