β‘ Blazing-fast Go Linter & Formatter ββ up to ~100x faster linting (self-reported benchmarks)
woofmt is an extremely fast Go code quality tool written in Rust, bringing real-time code checking to the vibe coding world. Designed from scratch for extreme performance.
π δΈζζζ‘£
| Scenario | woofmt | golangci-lint | staticcheck | Speedup |
|---|---|---|---|---|
| Cold Start | 12ms | ~100ms | ~50ms | 5-10x |
| Hot Run (single file) | 2ms | ~300ms | ~100ms | 50-100x |
| 100 files batch | 24ms | ~3000ms | ~800ms | 30-100x |
| 1000 files project | 150ms | ~20s | ~5s | 30x |
| 5000 files large project | 600ms | ~60s | ~15s | 25x |
Test environment: 12-core CPU, SSD. All numbers below are self-reported β
the benchmark scripts live in benchmark/ and third-party
reproduction is welcome. Treat "up to ~100x" as the upper bound observed on
lint-heavy workloads; formatting a file that gofmt already handles in
milliseconds is not 100x of anything.
π¦ Native Rust Performance
ββ Zero-cost abstractions
ββ No GC pauses
ββ Extreme memory control
β‘ Smart Cache Architecture
ββ Parser pooling (99% reuse)
ββ AST LRU cache (1000 slots)
ββ Hot run 2ms response
π Parallel Processing
ββ Data-level parallelism (Rayon)
ββ 12-core 3.55x speedup
ββ 256-core hierarchical scheduling
πΎ Memory Optimization
ββ Arena allocator
ββ Zero-copy I/O (mmap)
ββ 60% peak memory reduction
| Feature | Description |
|---|---|
| π Extremely Fast | Cold start 12ms, hot run 2ms |
| π¦ All-in-One | Lint + Format + Simplify + Imports |
| π― Precise | Tree-sitter AST, zero false positives |
| π Incremental | Only check changed files |
| π LSP Support | Real-time diagnostics |
| β‘ Parallel | Full utilization of multi-core |
| π§© Plugin System | Custom rules supported |
| π Multiple Reports | JSON/SARIF/GitHub Actions |
cargo install woofmtcurl -fsSL https://raw.githubusercontent.com/GWinfinity/woofmt/main/install.sh | bash# Linux/macOS/Windows
wget https://github.com/GWinfinity/woofmt/releases/latest/download/woofmt-$(uname -s)-$(uname -m)
chmod +x woofmt-*
sudo mv woofmt-* /usr/local/bin/woofmt# Check current directory
woofmt check
# Check specific file
woofmt check main.go
# Check and auto-fix
woofmt check --fix
# Check with JSON output
woofmt check --format json# Format current directory
woofmt fmt
# Format with write (in-place)
woofmt fmt --write
# Check if formatted
woofmt fmt --check# Run all enabled rules (the `check` subcommand IS the linter)
woofmt check
# Run specific rules
woofmt check --select "E115,F401,C001"
# Auto-fix safe issues (add --unsafe-fixes for semantic edits)
woofmt check --fixwoofmt check [OPTIONS] [PATHS...]
Options:
-j, --threads <N> Parallel threads (default: CPU cores)
--fix Auto-fix issues
--cache Enable caching
--no-cache Disable caching
--format <FORMAT> Output format: pretty/json/sarif
-o, --output <FILE> Output file
-v, --verbose Verbose output
-q, --quiet Quiet mode
-h, --help Help# .woofmt.toml
[format]
tab_width = 4
use_tabs = false
max_line_length = 100
[lint]
enabled_rules = ["all"]
disabled_rules = ["ST1000"]
severity = "warning"
[cache]
enabled = true
directory = ".woofmt_cache"
max_size = "1GB"
[parallel]
threads = 12βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β woofmt Architecture β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β β
β βββββββββββββββ βββββββββββββββ βββββββββββββββ β
β β Parser β β Analyzer β β Reporter β β
β β(tree-sitterβββββΆβ Engine βββββΆβ (Multi) β β
β β pool) β β β β β β
β ββββββββ¬βββββββ βββββββββββββββ βββββββββββββββ β
β β β
β βΌ β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β Parallel File Processor β β
β β (Rayon) β β
β β ββββββββββ ββββββββββ ββββββββββ ββββββββββ β β
β β β File 1 β β File 2 β β File 3 β β File N β β β
β β ββββββββββ ββββββββββ ββββββββββ ββββββββββ β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β Smart Cache Layer β β
β β ββ Parser Pool (99% reuse) β β
β β ββ AST LRU Cache (1000 slots) β β
β β ββ File Hash Cache β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
$ hyperfine --warmup 3 'woofmt check' 'golangci-lint run'
Benchmark 1: woofmt check
Time (mean Β± Ο): 12.4 ms Β± 1.2 ms
Range (min β¦ max): 10.8 ms β¦ 15.1 ms
Benchmark 2: golangci-lint run
Time (mean Β± Ο): 2.341 s Β± 0.123 s
Range (min β¦ max): 2.156 s β¦ 2.567 s
Summary: woofmt is 188.8x faster
β οΈ This is a single-directory cold run: golangci-lint pays its full analyzer-startup cost while woofmt does one cache-warm parse pass. It is the best case, not a typical speedup. See the table above for per-scale numbers.
| Tool | Cold Start Memory | Peak Memory |
|---|---|---|
| woofmt | 45MB | 180MB |
| golangci-lint | 120MB | 450MB |
| staticcheck | 80MB | 320MB |
woofmt is pre-1.0, early stage. What is real today:
- β
Working
check/fmt/lintCLI with parallel parsing (tree-sitter, Rayon) - β
Working safe auto-fixes (
woofmt check --fixapplies only mechanical fixes such as E115 trailing whitespace; semantic edits require--unsafe-fixes) - β
Formatter idempotency regression tests (
tests/gofmt_compat.rs) and a gofmt byte-comparison harness (scripts/gofmt_compat.sh) enforced in CI - β
Single-binary install (
cargo install woofmtships exactly one binary)
What is not ready (see docs/RULES.md for details):
- β No type information (tree-sitter) β SA-series rules are syntax-level approximations of staticcheck, not replacements
- β No cross-package
unusedanalysis - β gofmt byte-compatibility is structural, not yet 100% on all constructs
- β Rule set still small compared to golangci-lint's analyzer ecosystem
Recommended deployment: use woofmt for real-time/editor feedback and cheap CI layers; keep golangci-lint/staticcheck for deep PR checks. See docs/MIGRATION.md.
Contributions welcome! Please see CONTRIBUTING.md.
git clone https://github.com/GWinfinity/woofmt.git
cd woofmt
cargo test
cargo benchApache License 2.0 Β© GWinfinity
Made with β€οΈ and π¦ Rust
"woofmt brings real-time code checking to vibe coding."