Skip to main content
The bugster plugin command installs test generation rules for AI coding agents like Cursor or Claude Code, enabling them to create and update Bugster test specifications without leaving your editor.

​
Basic Usage

bugster plugin

​
Command Overview

Installs rule files that teach your AI coding agent how to generate and maintain Bugster test specifications directly in your development environment.

​
When to Use

  • After setting up Bugster in your project for the first time
  • When switching to a new AI coding agent
  • To update rules when new versions are released
  • When setting up a new team member’s development environment

​
Key Features

  • Interactive agent selection (Cursor or Claude Code)
  • Installs both generation and update rules
  • Safe installation with overwrite protection
  • Downloads official rules from Bugster repository
  • Works seamlessly with your existing workflow
Requires internet connection to download the latest rule files from the official Bugster GitHub repository.

​
Command Syntax

bugster plugin [options]

​
Options

​
--agent
string
Specify the coding agent to install rules for. Accepts cursor or claude. Skips the interactive selection prompt.
​
--force
boolean
Overwrite existing rule files without confirmation. Useful for updating to the latest rule versions.

​
What Gets Installed

The command installs two rule files specific to your coding agent:
  1. Generate Rule: Creates new test specifications from your codebase
  2. Update Rule: Updates existing test specs based on code changes
  • Cursor
  • Claude Code
Installation Location: .cursor/rules/Files installed:
  • bugster-generate.mdc - Test generation rule
  • bugster-update.mdc - Test update rule
Source: Cursor Plugin Rules

​
Examples

​
Interactive Installation

bugster plugin
Prompts you to select your coding agent and installs the appropriate rules.

​
Install for Cursor

bugster plugin --agent cursor
Directly installs Bugster rules for Cursor without prompting.

​
Install for Claude Code

bugster plugin --agent claude
Installs Bugster rules for Claude Code with no interactive prompt.

​
Force Update Existing Rules

bugster plugin --agent cursor --force
Overwrites existing rule files to update to the latest versions.

​
Using the Rules in Your Editor

1

Open Your Editor

Launch Cursor or Claude Code in your project directory where Bugster is configured.
2

Reference the Rule

In your AI chat, mention @bugster-generate or @bugster-update to activate the corresponding rule.
Your coding agent will now understand how to create and update Bugster test specifications.
3

Generate Tests

Ask your AI agent to create tests for specific files, components, or user flows.

​
Example Prompts

  • Generate Tests
  • Update Tests
  • Comprehensive Coverage
  • Feature Testing
@bugster-generate Create tests for src/components/LoginForm.tsx
Generates comprehensive test coverage for a specific component.

​
Rule Capabilities

Smart Generation

AI understands your code structure and creates relevant test scenarios automatically.

YAML Format

Generates properly formatted test specs that work with bugster run.

Incremental Updates

Updates existing tests when your code changes without duplicating specs.

Best Practices

Follows Bugster conventions for selectors, assertions, and test structure.

​
Workflow Integration

After installation, your typical workflow becomes:
  1. Write or modify application code
  2. Reference @bugster-generate in your AI chat
  3. Ask your coding agent to create tests for the changes
  4. Review and commit the generated test specs
  5. Run tests with bugster run
Run bugster plugin --force periodically to ensure you have the latest rule versions with improved test generation capabilities.
The rules require your coding agent to have access to your project files. Ensure your editor has proper permissions to read the .bugster/ directory.

​
Best Practices

  • Version Control: Commit the rule files to your repository so the entire team benefits
  • Regular Updates: Use --force to update rules when Bugster releases new versions
  • Consistent Usage: Reference the rules consistently across your team for uniform test quality
  • Combine with Generate: Use plugin rules for targeted test creation and bugster generate for comprehensive coverage