Commands
LeftSize provides interactive commands you can use directly in GitHub Issue comments. Type a command and LeftSize will respond with a comment containing the requested information.
Guidance commands
These commands provide detailed remediation guidance for the finding in the current issue.
@leftsize explain
Get a detailed explanation of why this resource was flagged and what the finding means.
@leftsize howto
Get step-by-step remediation instructions for resolving the finding. Alias: @leftsize how-to
@leftsize impact
Get a cost, performance, or security impact analysis for the finding.
@leftsize alternatives
Get alternative approaches for addressing the finding, beyond the primary recommendation. Alias: @leftsize options
@leftsize script <type>
Get a ready-to-use remediation script. Supported types:
| Type | Description |
|---|---|
azure-cli |
Azure CLI commands (default) |
powershell |
PowerShell commands |
terraform |
Terraform configuration |
bicep |
Azure Bicep templates |
pulumi |
Pulumi code |
Example: @leftsize script terraform
If no type is specified, azure-cli is used by default.
@leftsize prompt
Get a pre-written prompt you can paste into ChatGPT, GitHub Copilot, or Claude to get help with remediation.
Issue management commands
These commands control the lifecycle of findings.
@leftsize snooze <duration>
Temporarily suppress the finding. The issue is closed and won’t resurface until the snooze period expires. If the resources are still flagged after the snooze expires, a new issue is created.
Supported duration formats:
| Format | Example | Range |
|---|---|---|
| Days | 14d |
1-365 |
| Weeks | 2w |
1-52 |
| Months | 3m |
1-12 |
| Years | 1y |
1-5 |
Default: 14d (if no duration specified)
Example: @leftsize snooze 3m
@leftsize ignore <reason>
Permanently suppress the finding for the affected resources. The issue is closed as “not planned” and won’t resurface for the same set of resources.
Providing a reason is recommended so your team understands why the finding was dismissed.
Example: @leftsize ignore reason="This is a shared dev environment, cost is accepted"
@leftsize wrong <reason>
Report a false positive. This:
- Creates a suppression for the affected resources (180 days)
- Submits feedback to the LeftSize team so the rule can be improved
- Closes the issue as “not planned”
Aliases: @leftsize false-positive, @leftsize fp
Example: @leftsize wrong This VM handles batch jobs that run on weekends
@leftsize feedback <message>
Send general feedback about the finding or LeftSize to the team. The issue stays open.
Example: @leftsize feedback The savings estimate seems too high for this resource type
Plan restrictions
On the Free plan, guidance commands (explain, howto, impact, alternatives, script, prompt) are available for free-tier rules only. Using a guidance command on a Pro rule will show an upgrade prompt.
Issue management commands (snooze, ignore, wrong, feedback) are available on all plans.
Safety
LeftSize is strictly read-only. Commands that would modify infrastructure (stop, delete, terminate, deallocate, resize, etc.) are intentionally blocked and will return a message explaining that LeftSize does not perform infrastructure changes.