Extend Neovim's gx to open anything under your cursor!
gx-extended.nvim supercharges Neovim's built-in gx command. Press gx on anything — package names, import statements, issue numbers, commit hashes, and more — and it opens the right URL in your browser.
Before: gx only worked on URLs
After: gx works on 20+ different patterns across all your files!
- 🚀 19 built-in handlers — npm, cargo, docker, terraform, git, and more
- 🎯 Deterministic ordering — Predictable priority system (first defined = first checked)
- 🎁 4 optional power features — NPM imports, GitHub permalinks, Jira, Linear
- 🔧 Zero config needed — Works out of the box
- 🎨 Fully extensible — Add your own patterns easily
- 📚 900+ lines of docs — Examples for everything
- ⚡ Lightweight — Heavy features are opt-in
Press gx on any of these:
import express from "express" // → Opens npmjs.comserde = "1.0" // → Opens crates.ioFROM nginx:alpine // → Opens hub.docker.comFixed CVE-2024-1234 // → Opens nvd.nist.gov
See commit a1b2c3d // → Opens GitHub commit
Visit docs.github.com // → Opens with https://📦 Package Managers (7 supported)
| Language | File | Example | Opens |
|---|---|---|---|
| JavaScript/TypeScript | package.json |
"express": "^4.18.2" |
npmjs.com |
| Rust | Cargo.toml |
serde = "1.0" |
crates.io |
| Go | go.mod |
github.com/gin-gonic/gin |
pkg.go.dev |
| Python | requirements.txt |
django>=4.0 |
pypi.org |
| Ruby | Gemfile |
gem "rails" |
rubygems.org |
| Homebrew | Brewfile |
brew "neovim" |
formulae.brew.sh |
| Docker | Dockerfile |
FROM nginx |
hub.docker.com |
☁️ Infrastructure & DevOps
- Terraform (
*.tf) — AWS/GCP resource documentationresource "aws_instance"→ Terraform Registry
- Docker — Official images and user repositories
FROM nginx:alpine→ Docker HubFROM user/image:tag→ Docker Hub
🔗 Git & Version Control
- Git Commits — Opens on GitHub/GitLab/Bitbucket
a1b2c3d→ commit page (auto-detects remote)
- GitHub Permalinks ⭐ (optional) — Share exact code locations
- Press
gxon any line →github.com/repo/file.ts#L42
- Press
📝 Documentation & References
- Markdown Links —
[text](url)→ Opens URL - CVE References —
CVE-2024-1234→ NVD database - Python PEPs —
PEP 8→ Python Enhancement Proposals - URLs without protocol —
google.com→https://google.com
🔌 Neovim Plugins
- Works with Packer, Lazy.nvim, vim-plug
'user/plugin'→ Opens GitHub repository
🎁 Optional Power Features
Enable these for even more power:
| Feature | What it does | Enable with |
|---|---|---|
| NPM Imports | import axios from "axios" → npm |
enable_npm_imports = true |
| GitHub Permalinks | Any line → GitHub link with line number | enable_github_file_line = true |
| Jira Tickets | PROJ-123 → Your Jira |
vim.g.gx_jira_url |
| Linear Issues | ENG-456 → Your Linear |
vim.g.gx_linear_team |
lazy.nvim (recommended)
{
'rmagatti/gx-extended.nvim',
keys = { 'gx' },
config = function()
require('gx-extended').setup {}
end
}use {
'rmagatti/gx-extended.nvim',
config = function()
require('gx-extended').setup {}
end
}Plug 'rmagatti/gx-extended.nvim'Then in your init.lua:
require('gx-extended').setup {}require('gx-extended').setup {}That's it! All built-in features work out of the box.
require('gx-extended').setup {
-- Optional: NPM imports in JS/TS files
enable_npm_imports = true,
-- Optional: GitHub file line permalinks
enable_github_file_line = true,
-- Optional: Custom browser
open_fn = require('lazy.util').open,
}require('gx-extended').setup {
extensions = {
{
patterns = { "*" },
name = "Jira Tickets",
match_to_url = function(line_string)
local ticket = string.match(line_string, "([A-Z]+-[0-9]+)")
if ticket then
return "https://yourcompany.atlassian.net/browse/" .. ticket
end
end,
},
},
}📚 See full configuration guide →
- Move cursor over a pattern (package name, URL, commit hash, etc.)
- Press
gxin normal mode - Opens in your browser!
Also works in visual mode — Select text and press gx
When multiple handlers match, you get a menu:
Multiple patterns matched. Select one:
> Docker Hub
Git Commit
No-protocol URLs
Use ↑↓ to select, Enter to open.
We've made testing easy! Try it out:
cd ~/.local/share/nvim/lazy/gx-extended.nvim/test-samples
./test-runner.shOr manually test any feature:
nvim package.json
# Move cursor to "express" and press gx📚 See complete testing guide →
| Document | What's inside |
|---|---|
| ADVANCED.md | Optional features, custom extensions, power-user configs (600+ lines) |
| EXAMPLES.md | Real-world examples for every feature (400+ lines) |
| TESTING.md | Complete testing guide with test files (540+ lines) |
Contributions are welcome!
- 💡 Have an idea? Open an issue
- 🐛 Found a bug? Report it
- 🔧 Want to add a feature? Submit a PR!
See ADVANCED.md for examples of custom extensions. We're always open to adding more built-in handlers!
Extensions are checked in registration order:
- File-specific handlers (package.json, Cargo.toml, etc.)
- Markdown handlers
- Git handlers
- Reference handlers (CVE, PEP)
- Fallback handlers (no-protocol URLs)
- Your custom extensions
First match wins! If multiple match, you get a menu.
Key improvement: Extensions are checked in the exact order they're registered. No more random behavior!
This means:
- Predictable — Same pattern always wins
- Configurable — Control priority by registration order
- Debuggable — Easy to understand what's happening
Example: File-specific handlers are registered first, so they always take priority over generic patterns.
- 19 total extensions (15 built-in + 4 optional)
- 7 package managers supported
- 3 git platforms (GitHub, GitLab, Bitbucket)
- 20+ file types covered
- 900+ lines of documentation
- Zero dependencies (besides Neovim 0.5+)
- stsewd/gx-extended.vim — The original gx-extended for Vim
- chrishrb/gx.nvim — Another excellent Neovim implementation
MIT License - see LICENSE for details
