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.

ModelBest ForSpeed / Cost
haikuQuick tasks, simple explanationsFastestCheapest
sonnetStandard development tasksBalancedDefault
opusComplex architectural tasksMost capable

Examples

Use Opus for complex refactoring
@Smart Workflow ship api refactor the auth system --model opus
Use Haiku for quick explanations
@Smart Workflow explain what does this function do --model haiku

Automatic Model Routing

When no model is specified, Smart Workflow scores task complexity and routes to the appropriate model:

Increases complexity:

  • ship command
  • Keywords: refactor, migrate, architecture
  • Long prompts

Decreases complexity:

  • explain command
  • 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 chars

Repository 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 caching

PR link

@Smart Workflow fix https://github.com/org/repo/pull/42 address comments
@Smart Workflow rebase https://github.com/org/repo/pull/42

Shorthand

@Smart Workflow fix my-repo #42 fix typo
@Smart Workflow review api 15