refrax

# Refrax

[![codecov](https://codecov.io/gh/cqfn/refrax/branch/master/graph/badge.svg)](https://codecov.io/gh/cqfn/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:

```bash
go install github.com/cqfn/refrax@latest
```

To install a specific version, use:

```bash
go install github.com/cqfn/[email protected]
```


### From Source

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

1. Clone the repository:

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

2. Build the binary:

   ```bash
   go build -o refrax
   ```

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

   ```bash
   go install
   ```

## Usage

[![asciicast](https://asciinema.org/a/IHrW8v68VS81vVNfw8ByioG4T.svg)](https://asciinema.org/a/IHrW8v68VS81vVNfw8ByioG4T)

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