Back to all resources
go-modern-guidelines Apache-2.0 · free Claude Code, Codex, Cursor, Junie LIVE

Stop shipping Go your model forgot to update.

Every coding agent defaults to the Go it saw most in training, which means `for i := 0; i < n; i++` instead of `for i := range n`, and no idea `errors.AsType[T]` exists at all. This plugin reads your `go.mod`, detects the version, and gives the agent the modern idiom for everything up to Go 1.27. It runs itself once installed. Nothing leaves your machine.

By Raj Singh · September 2026 · Official JetBrains project · 3.4k stars · 5 min read

WHAT IT LOOKS LIKE

There is no dashboard for this one, it has no UI of its own. It sits inside the agent's context and changes what comes out the other end, the way a leverage curve moves quietly in the background of every other tool you run.

A dark dashboard showing a leverage curve, standing in for the guidelines working quietly in the background
No screen of its own, working in the backgroundAgileSingh
BEFORE YOU INSTALL IT

It reads your go.mod first. The guidelines detect the project's declared Go version and only suggest idioms available up to that version. A repo pinned to Go 1.22 will not get code that needs 1.26.

Needs Go on your PATH. The marketplace integrations run a small CLI installed on first use with go install. It caches to ~/.cache/go-modern-guidelines and never touches your project files directly.

Auto-update is off by default. Claude Code disables automatic updates for third-party marketplaces unless you turn it on. Skip that one setting and the guidelines quietly stop tracking new Go releases, which defeats the point.

It covers Go 1.0 through 1.27. Every feature the built-in modernize analyzer targets is in FEATURES.md, so the guidelines are keeping pace with the same list the Go team maintains, not a private opinion of what modern means.

Licence, in plain English: Apache-2.0. Free for commercial work, fine to fork or embed, no obligation beyond keeping the licence file.

Honest limitIt fixes idiom, not architecture. A model that reaches for the wrong data structure or the wrong concurrency pattern still reaches for it, just in more modern syntax.
Read the whole setup

Get the setup that works.

Drop your email and unlock the rest: what you need, the install for your agent of choice, the one setting to flip, and how to confirm it is actually firing.

One email. No follow-up unless I ship something that fits.

WHAT YOU NEED
  • The Go toolchain installed and on your PATH
  • Claude Code, Codex, Cursor or Junie, any one is enough
  • GOTOOLCHAIN=auto, the default, so an older local Go can still fetch a compatible one on first run
INSTALL

Two commands inside Claude Code

Run both from inside a Claude Code session. The plugin installs into your existing plugin system, nothing project-local.

The install

claude code sessionrun in order
/plugin marketplace add JetBrains/go-modern-guidelines /plugin install modern-go-guidelines@goland-claude-marketplace → guidelines active on your next Go task

Codex and Cursor use the equivalent plugin marketplace add command from a terminal instead of inside a session. Junie uses /extensions marketplace add in its own CLI.

Prove itAsk the agent to write a function that finds the max of two ints. max(a, b) rather than an if-else block means the plugin is loaded and firing.
CONFIGURE

The one setting worth changing

There is no settings file. The only real configuration is whether Claude Code keeps this plugin current, and it does not by default.

claude codeone-time setting
/plugin → Marketplaces → goland-claude-marketplace → Enable auto-update
SettingDefaultWhy I change it
Auto-updateoff, third-party marketplacesA guidelines project that goes stale is worse than none. This is the whole reason to flip it.
Explicit invokeautomaticAutomatic is right almost always. Use /modern-go-guidelines:use-modern-go only when you want it applied to code the agent already wrote.
Manual update pathWithout auto-update, run claude plugin marketplace update goland-claude-marketplace then claude plugin update modern-go-guidelines@goland-claude-marketplace yourself, and remember to.
DAILY DRIVING

It runs itself

There is no workflow to learn. The agent invokes the skill automatically on Go tasks, and the only thing you do is occasionally check it fired.

  • Write Go normally. No special prompt or flag needed. The plugin loads into the agent's context on relevant tasks.
  • Force it once in a while. Run /modern-go-guidelines:use-modern-go directly if you want an existing file swept for outdated idioms.
  • Reload after an update. /reload-plugins applies a marketplace update to the current session without restarting Claude Code.

The value compounds quietly. You notice it less by what changed and more by how little pre-2023 Go shows up in review.

WHEN IT DRIFTS

Two failures, both configuration

Suggestions look outdated
Auto-update was never turned on. Run the manual update commands, then check FEATURES.md in the repo for what changed.
Plugin never seems to fire
go.mod is missing or unreadable from the project root. The version-detection step needs it to decide which idioms are safe to suggest.
ResetRemove the plugin and the local CLI cache at ~/.cache/go-modern-guidelines, then reinstall. Nothing in your project changes either way.
THE SHAPE OF IT

Where everything lives

~/.cache/go-modern-guidelinesthe installed CLI, fetched on first use FEATURES.mdevery guideline the plugin can suggest, with examples .claude-plugin/the Claude Code plugin manifest in this repo .cursor-plugin/ .junie-extension/the equivalent manifests for the other agents

Nothing writes to your project. Uninstalling the plugin from any agent leaves your code exactly as the agent last wrote it.

That is the whole setup

Two commands, one setting to flip, and the agent stops writing Go your model forgot existed. The idioms keep pace with the Go team's own modernizer as long as you leave auto-update on.

Open on GitHub →

↑ Unlocks the moment you submit the form above.

RS
WRITTEN BY

Raj Singh

I'm Raj Singh, founder of DebtOps.ai and a Claude certified partner. Over the last five years I've managed $25M in ads, built AI solutions for Fortune 100 companies, and installed AI operating systems and AI brains inside small businesses. Everything here is something I've shipped, debugged, or watched a client ship. My goal with AgileSingh is to make you irreplaceable in this AI age.

$25M
Ads managed · 5 yrs
F100
Enterprise AI builds
Claude
Certified partner
24
Guides shipped
More guides

Now set up the rest of the agent.

One language plugin is a good start. The Claude Code setup guide covers the operator manual, permission tiers and hooks that make every other language safer too.