---

name: ubs-scanner description: Bug scanning with UBS (Ultimate Bug Scanner). Use before commits, when scanning for bugs, when the user mentions "ubs", "bugs", "scan", or "code quality".

UBS (Ultimate Bug Scanner)

Scans for 1000+ bug patterns across multiple languages.

When This Applies

---

Pre-Commit (Required)

Run before every commit:

Copyubs --staged                       # Scan staged changes
ubs --staged --fail-on-warning     # Strict mode (exit 1 on any issue)

Fix all issues before committing. Rerun until clean.

---

Scanning Options

Copy# Scan current directory
ubs .

# Scan specific file
ubs path/to/file.ts

# Scan working tree changes vs HEAD
ubs --diff

# Verbose with code examples
ubs -v .

---

Profiles

Copy# Strict (fail on warnings) - for production code
ubs --profile=strict .

# Loose (skip nits) - for prototyping
ubs --profile=loose .

---

Language Filters

Copy# Single language
ubs --only=python .

# Multiple languages
ubs --only=typescript,javascript .

Supported languages:

• javascript, typescript
• python
• c, c++
• rust, go
• java, ruby

---

Output Formats

Copyubs . --format=json                # JSON
ubs . --format=jsonl               # Line-delimited JSON
ubs . --format=sarif               # GitHub Code Scanning

---

CI Integration

Copyubs --ci                           # CI mode
ubs --comparison baseline.json .   # Regression detection

---

Suppressing False Positives

Add to the line:

Copy// ubs:ignore
const result = eval(userInput); // ubs:ignore

---

Health Check

Copyubs doctor
ubs doctor --fix

---

Quick Reference

Copyubs --staged               # Pre-commit scan (required)
ubs --staged --fail-on-warning   # Strict pre-commit
ubs --diff                 # Working tree changes
ubs path/to/file           # Specific file
ubs --profile=strict .     # Production mode
ubs doctor --fix           # Health check

---

Workflow Integration

The standard pre-commit workflow:

Copy# 1. Run tests
npm test  # or pytest, etc.

# 2. Scan staged changes
ubs --staged

# 3. Fix any issues found
# 4. Re-run until clean
ubs --staged

# 5. Commit
git add -A && git commit

---

Anti-Patterns

---

See Also

• verification/ — Full pre-commit checklist
• bead-workflow/ — Bead close workflow includes UBS