SW
Smart Workflow
← Back to Home
Back to Commands

preview

Preview proposed changes without creating a PR. See exactly what Smart Workflow would modify before committing to changes.

Syntax

@Smart Workflow preview <repo> <description>

Examples

Preview a UI feature
@Smart Workflow preview my-app add dark mode toggle
Preview with scope constraint
@Smart Workflow preview landing-page add a contact form --only "src/components/*"
Preview API changes
@Smart Workflow preview api implement rate limiting for the /users endpoint

How it works

1

Analyzes structure

Examines your repository to understand the codebase.

2

Proposes changes

Generates code modifications based on your description.

3

Shows diff preview

Displays what would change in each file.

4

No side effects

Does NOT create any branch or PR—preview only.

Output includes

Summary of proposed changes

High-level overview of what would be modified.

List of affected files

Files that would be created, modified, or deleted.

Diff preview

Line-by-line changes for each file (up to 5 in Slack).

Best for

  • ✓Reviewing changes before committing to a PR
  • ✓Understanding what Claude would modify
  • ✓Complex changes where you want to verify the approach first
  • ✓Getting team feedback before making changes

💡 Pro Tips

  • •Use preview first for significant changes, then follow up with ship
  • •Share the preview output with teammates for feedback before creating the PR
  • •Use --only to limit scope for focused previews
explainship