atelico

atelico / gdstyle

Public

A fast, opinionated linter and formatter for GDScript (Godot 4.x), in Rust.

github.comatelicogdstyle formatter gdscript godot linter rust
14
1
94% credibility
Found May 30, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

gdstyle is a code quality tool for game developers who write scripts in GDScript for the Godot game engine. It acts like a friendly assistant that reads through your game code and points out anything that doesn't follow the standard style - things like inconsistent naming, messy formatting, or code that's hard to read. You can let it automatically fix most issues with a single click, or use it to check your code before sharing it with others. It works as a standalone program you download, or as a built-in panel inside the Godot editor itself. The tool checks 54 different rules covering everything from how you name your variables to how you order the parts of your code, helping teams keep their game projects organized and easy to maintain.

How It Works

1
🎮 Discover gdstyle

A game developer making games with Godot hears about a tool that keeps their GDScript code clean and consistent

2
📥 Install the tool

Downloads one small file and puts it on their computer - nothing else to install or set up

3
🔍 Check the code

Runs the tool on their game project and instantly sees a friendly list of style suggestions

4
Choose how to fix
⚡
Auto-fix everything

Runs a single command and watches all formatting problems disappear in seconds

✏️
Fix one thing at a time

Opens a special panel right inside the Godot editor to click and fix issues one by one

🎉 Code is clean and consistent

All GDScript files follow the official Godot style guide, and the project looks professional and well-maintained

Sign up to see the full architecture

3 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is gdstyle?

Gdstyle is a command-line linter and formatter for GDScript, the scripting language for Godot 4.x. It catches 54 different issues across naming conventions, code formatting, class member ordering, and general code quality, then automatically fixes what it can. Built in Rust, it ships as a single binary with no runtime dependencies. You point it at a file or directory, it reads your .gd files, and outputs violations or applies fixes in place. Beyond the CLI, it works as a Rust library you can embed in your own tools, and there's a Godot editor plugin that integrates linting and format-on-save directly into the editor.

Why is it gaining traction?

The killer feature is auto-fix that actually understands Godot projects. When you rename a signal or method with `--unsafe-fix`, it traces the change across every .gd file in your project *and* rewrites the corresponding wiring in .tscn and .tres scene files. Most linters stop at the source file. Gdstyle also reorders class members to match the official Godot style guide automatically, which nobody wants to maintain by hand. The formatter is idempotent by design--run it twice, you get the same output. For CI, it outputs JSON with specific exit codes and slots into GitHub Actions in about ten lines of YAML.

Who should use this?

Game developers working on Godot 4.x projects who care about consistent code across a team. Solo devs who want a formatter to handle the tedious stuff like member ordering and boolean operator style. Teams that want automated style enforcement without manually reviewing whitespace in pull requests. Anyone who has tried to rename a widely-used signal and then spent an hour tracking down stale connections in scene files.

Verdict

Gdstyle is the most complete GDScript tooling available right now, with 54 rules, cross-file refactoring, and a formatter that actually understands Godot's conventions. The credibility score of 0.949999988079071% reflects a very young project with only 14 stars and no crates.io release yet, so production use means pinning to a specific commit and watching for breaking changes. That said, the test coverage is substantial (383 tests), documentation is thorough, and the Rust implementation means it will only get faster. Worth adopting for projects that take GDScript seriously.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.