Skip to main content
Scopes let you focus on specific parts of a large repository, making wit faster and less noisy.

Overview

In a monorepo, you often only care about one package or service. Scopes limit all wit operations to the paths you specify.

Commands

View Current Scope

Output:
Or if no scope:

Set Scope

Examples:

Use Preset

Presets are predefined scopes in your config:

Clear Scope

Returns to operating on the entire repository.

Configuration

Define presets in .wit/config:

Effect on Commands

When a scope is set, these commands are affected:

Example Monorepo Structure

Working on Frontend

Using Presets

Use Cases

Focus During Development

Scoped Commits

Scoped History

CI/CD Pipelines

Tips

Set scope in your terminal profile for focused work:
Use scopes with other commands:

Limitations

  • Scopes are session-based (not persisted)
  • Some commands ignore scopes (e.g., branch, switch)
  • Scopes don’t affect file system operations