Configuration
Command Flags
Customize command behavior with flags. All commands support model selection and scope constraints.
Model Selection
Override automatic model selection with the --model flag.
| Model | Best For | Speed / Cost |
|---|---|---|
haiku | Quick tasks, simple explanations | Fastest•Cheapest |
sonnet | Standard development tasks | Balanced•Default |
opus | Complex architectural tasks | Most capable |
Examples
Use Opus for complex refactoring
@Smart Workflow ship api refactor the auth system --model opusUse Haiku for quick explanations
@Smart Workflow explain what does this function do --model haikuAutomatic Model Routing
When no model is specified, Smart Workflow scores task complexity and routes to the appropriate model:
Increases complexity:
shipcommand- Keywords: refactor, migrate, architecture
- Long prompts
Decreases complexity:
explaincommand- Keywords: typo, simple, fix
- Thread context available
Scope Constraints
Limit which files can be modified using --only and --exclude flags.
--only <pattern>
Only allow modifications to files matching the pattern.
@Smart Workflow ship my-app add validation --only "src/components/*"@Smart Workflow ship api update endpoints --only "src/routes/**/*.ts"--exclude <pattern>
Prevent modifications to files matching the pattern.
@Smart Workflow ship my-app fix bugs --exclude "*.test.ts"@Smart Workflow ship api refactor --exclude "package.json,*.lock"Combining Both
Use both flags together for precise control:
@Smart Workflow ship my-app update styles --only "src/*" --exclude "src/test/*"Pattern Syntax
*Matches any characters in a single path segment**Matches any characters including path separators*.ts,*.tsxComma-separated patterns"src/**"Quote patterns with special charsRepository Selection
Multiple ways to target a specific repository:
Direct format
@Smart Workflow ship my-repo add feature
@Smart Workflow explain other-org/their-repo how auth works"in" keyword
@Smart Workflow in my-repo explain how auth works
@Smart Workflow in pdf-api ship add cachingPR link
@Smart Workflow fix https://github.com/org/repo/pull/42 address comments
@Smart Workflow rebase https://github.com/org/repo/pull/42Shorthand
@Smart Workflow fix my-repo #42 fix typo
@Smart Workflow review api 15