OhMyBug

Automatically scan and fix code quality issues across Swift, JavaScript/TypeScript, Flutter/Dart, and Python projects.

CLI: macOS + Windows | GUI App: macOS (SwiftUI) + Windows (Tauri)

Features

• Multi-language support — Swift (SwiftLint, SwiftFormat), JS/TS (ESLint, Prettier), Dart/Flutter (dart analyze, dart format), Python (Ruff)
• Framework detection — Auto-detects React, Next.js, Vue, Nuxt.js, Express, NestJS and checks for proper ESLint setup
• Build verification — Checks your project builds before and after fixes
• AI-powered fixes — Uses GLM (CodeGeeX-4) for issues that tools can't auto-fix
• Safe by default — Creates file backups before any fix. Auto-rollback if build fails after fixing
• 2-phase workflow — Scan → Review → Fix. No surprise changes
• Export reports — SARIF, HTML, Markdown, JSON, Text formats
• Cross-platform — CLI and GUI apps for both macOS and Windows

Supported Languages & Frameworks

Language	Tools	Frameworks
Swift	SwiftLint, SwiftFormat	iOS, macOS apps
JavaScript/TypeScript	ESLint, Prettier	React, Next.js, Vue, Nuxt.js, Express, NestJS
Dart/Flutter	dart analyze, dart format	Flutter apps
Python	Ruff	Django, FastAPI, Flask, etc.

Platform Support

Feature	macOS	Windows
CLI	✅	✅
GUI App (SwiftUI)	✅	❌
GUI App (Tauri)	✅	✅
Swift scanning	✅	❌
JS/TS scanning	✅	✅
Dart/Flutter scanning	✅	✅
Python scanning	✅	✅
AI-powered fixes (GLM)	✅	✅

Note: Swift tools are not available on Windows, so Swift-related scanners are automatically disabled.

Requirements

macOS

• macOS 14.0+
• Swift 5.9+
• Xcode 15+ (or Swift toolchain)

Windows

• Windows 10+
• Node.js (for ESLint/Prettier)
• Flutter SDK (for Dart/Flutter projects)
• Python + Ruff (for Python projects)

Optional Tools (auto-detected)

Tool	For	macOS Install	Windows Install
SwiftLint	Swift linting	brew install swiftlint	N/A (macOS only)
SwiftFormat	Swift formatting	brew install swiftformat	N/A (macOS only)
Node.js + npx	JS/TS linting & formatting	brew install node	nodejs.org
Flutter SDK	Dart/Flutter analysis	flutter.dev	flutter.dev
Ruff	Python linting & formatting	brew install ruff	pip install ruff

OhMyBug only runs scanners for tools that are installed. No tool = scanner skipped.

Installation

CLI (macOS)

git clone https://github.com/insightflo/ohmybug.git
cd ohmybug/OhMyBugCore
swift build -c release

# The binary is at:
# .build/release/ohmybug

# Optional: copy to PATH
cp .build/release/ohmybug /usr/local/bin/

CLI (Windows)

git clone https://github.com/insightflo/ohmybug.git
cd ohmybug\OhMyBugCore
swift build -c release

# The binary is at:
# .build\release\ohmybug.exe

macOS App (SwiftUI)

cd ohmybug/OhMyBugApp
./build-app.sh

# App bundle created at:
# .build/release/OhMyBug.app

Or open OhMyBugApp/Package.swift in Xcode and run.

Windows/Cross-platform App (Tauri)

cd ohmybug/OhMyBugWindows
npm install
npm run tauri dev      # Development
npm run tauri build    # Production build

Requires: Rust, Node.js

Usage

CLI

# Scan only (default)
ohmybug check /path/to/project --verbose

# Scan + auto-fix (creates backup, rollback on build failure)
ohmybug check /path/to/project --fix

# Scan + fix with AI (GLM CodeGeeX-4)
ohmybug check /path/to/project --fix --glm-key YOUR_API_KEY

# Export report
ohmybug check /path/to/project --format markdown --output report.md
ohmybug check /path/to/project --format sarif --output report.sarif
ohmybug check /path/to/project --format html --output report.html

GUI App

1. Launch the app
2. Drag & drop a project folder (or click to open)
3. Click Scan Project — review the report
4. Click Apply Fixes — backup is created automatically
5. If something breaks → click Rollback

Settings:

• Auto-apply fixes — Automatically fix issues after scanning
• Run build check — Verify project builds after fixes

GLM API Key

OhMyBug uses Zhipu AI's CodeGeeX-4 for AI-powered fixes. The API key is:

• CLI: passed via --glm-key flag (never stored)
• App: entered in the Settings panel (stored locally, never leaves your machine)

Architecture

ohmybug/
├── OhMyBugCore/             # SPM library + CLI (cross-platform)
│   ├── Sources/
│   │   ├── OhMyBugCore/
│   │   │   ├── Models/      # Issue, ScanResult, FixResult, PipelineReport
│   │   │   ├── Scanners/    # SwiftLint, SwiftFormat, ESLint, Prettier, Dart, Flutter, Ruff, BuildChecker
│   │   │   ├── Fixers/      # LLMClient (GLM), AIFixer
│   │   │   ├── Pipeline/    # PipelineEngine (actor), scanner registration
│   │   │   └── Utils/       # ShellRunner, ToolInstaller, ProjectDetector, BackupManager, ReportFormatter
│   │   └── OhMyBugCLI/      # CLI entry point
│   └── Tests/
├── OhMyBugApp/              # SwiftUI macOS app
│   └── OhMyBugApp/
│       ├── Views/           # ProjectDropZone, PhaseIndicator, LogView, ResultsDashboard, ScanReportView, SettingsPanel
│       ├── ViewModels/      # AppViewModel, AppSettings
│       └── Theme.swift      # Dark theme
└── OhMyBugWindows/          # Tauri app (Rust + React) for Windows/cross-platform
    ├── src/                 # React frontend
    ├── src-tauri/           # Rust backend
    └── package.json

How it works

1. Detect — ProjectDetector identifies project type (Swift / JS / Flutter / Python / mixed)
2. Register — PipelineEngine registers relevant scanners for the detected type
3. Scan — Each scanner runs its tool and returns ScanResult with issues
4. Report — Issues aggregated into ScanReport (by severity, scanner, rule, file)
5. Fix — Tool-based auto-fix first, then AI fixer for remaining issues
6. Verify — Re-scan + build check after fixes
7. Rollback — If build fails, BackupManager restores all files

Key design decisions

• PipelineEngine is a Swift actor for safe concurrency
• Views use @Observable (Swift 5.9 Observation framework)
• BuildChecker searches subdirectories for buildable targets
• All shell commands run via ShellRunner with OS-specific shell detection
• Platform-specific code uses #if os(Windows) / #if os(macOS) conditionals
• Tauri app provides cross-platform GUI with native performance

License

MIT