Skip to main content
The bugster shell provides a persistent, interactive environment for running tests and commands. Type natural language to test instantly, browse commands with /, and navigate files with @.

​
Quick Start

bugster

​
Core Concepts

/

Command BrowserType / to browse and autocomplete all Bugster commands

@

File NavigatorType @ to interactively select test or source files

Natural Text

Inline TestsType 5+ words to instantly run a test

​
Usage Examples

# Start shell
bugster

# Browse and run command
/generate --page @

# Quick inline test (5+ words required)
test login form with invalid email addresses

# Run specific test file
/run @

# Exit
/exit

​
Key Features

  • No bugster prefix needed - Direct command execution
  • Command history - Use ↑/↓ arrows to navigate previous commands
  • Smart file filtering - /run @ shows only tests, /generate --page @ excludes tests
  • Persistent session - Stay in context across multiple operations
  • Instant execution - Natural language (5+ words) runs tests immediately

​
Keyboard Shortcuts

KeyAction
/Command browser
@File browser
↑ ↓Navigate history/items
EnterExecute/Select
Ctrl+C × 2Exit shell

​
Common Commands

/generate              # Generate tests
/run                   # Run all tests
/run --fast           # Run tests in fast mode
/update               # Update test specs
/validate             # Validate config
Use the shell for active development sessions. It’s faster than one-off commands and maintains your workflow context.
Inline tests require at least 5 words. Shorter phrases won’t execute as tests.