gorefactor

gorefactor

AST-based Go refactoring tool for LLM agents.

Install

go install github.com/night-codes/gorefactor@latest

Commands

Project Overview

gorefactor project              # Structure and stats
gorefactor packages             # List all packages
gorefactor symbols ./pkg        # All symbols in package
gorefactor api ./pkg            # Public API only

Find (project-wide search)

gorefactor find <name> [dir]      # Find symbol (func, type, var, const, field)

Read Code

gorefactor read <name> [file]     # Read code of function or type

Modify Code

# Replace function
echo 'func ProcessOrder(ctx context.Context, id int) error {
    return nil
}' | gorefactor replace ProcessOrder

# Delete function
gorefactor delete OldHandler

# Add function to specific file
echo 'func NewHelper() {}' | gorefactor add helpers.go

# Move function between files
gorefactor move ProcessOrder newfile.go

Navigation (via gopls)

gorefactor definition UserService    # Where defined
gorefactor references ProcessOrder   # All usages
gorefactor implementations Reader    # Types implementing interface
gorefactor callers SaveUser          # Who calls this

Refactoring (via gopls)

gorefactor rename OldName NewName    # Rename globally

Validation

gorefactor check     # go build + go vet
gorefactor test      # Run tests

Output

All commands return JSON:

{
	"success": true,
	"name": "ProcessOrder",
	"file": "/path/to/service.go",
	"line": 42,
	"code": "func ProcessOrder(...) { ... }"
}

Why This Tool?

For LLM agents working with Go code:

Requirements

• Go 1.21+
• gopls (for navigation/rename commands)

License

MIT