Command-Line Agentic Refactoring of Java Code

Refrax

⚠️ Early prototype — subject to rapid change.

Refrax is an AI-powered refactoring agent for Java code, implemented in Go.

We often need our source code to be polished by AI agents (like [Claude Code]), for example typos to be fixed, small refactorings applied, and JavaDoc blocks improved. But we struggle to formulate the prompt correctly. A simple "make my code better" may not work for two reasons: the agent quickly gets lost when it deals with hundreds of files, and the agent requires regular interaction with the user. Refrax solves both of these issues by breaking down a large demand to polish the code into a series of smaller requests to a number of agents with their specific roles: a critic, a reviewer, an editor, and so on. You just start Refrax and in a few minutes (or hours) it makes your code better, running fully autonomously.

Refrax integrates a number of LLMs communicating via the [A2A] protocol.

Installation

Releases

Download the latest stable version from the [releases] page. Pre-built binaries are available for macOS, Windows, and Linux.

Using Go

If you have Go 1.24.1 or later installed, you can run:

go install github.com/cqfn/refrax@latest

To install a specific version, use:

go install github.com/cqfn/refrax@v0.0.1

From Source

Ensure that Go 1.24.1 or later is installed on your system.

1. Clone the repository:

   git clone https://github.com/cqfn/refrax.git
   cd refrax
   

2. Build the binary:

   go build -o refrax
   

3. (Optional) Install the binary to your $GOPATH/bin:

   go install
   

Usage

• refrax refactor [path]: Refactor Java code in the specified directory (defaults to current