Getting Started

Get started with RefactorAI

RefactorAI reviews and refactors local Git commits before they become PRs, so teams can keep their editor and Git workflow while reducing PR review load.

8 minNew users and onboarding teams

What you get

  • A local Git hook that reviews commits created from terminal, VS Code, Cursor, JetBrains, or most Git GUIs.
  • An always-on Refactor Terminal that shows commit status, gate verdicts, and Refactor Requests.
  • Pre-push policy controls so teams can start in warn mode and graduate to strict.
  • Traceable events and auditability for security and compliance teams.

Editor-neutral by design

RefactorAI watches Git itself, not a specific editor. Developers can keep committing from their preferred Source Control panel, IDE commit dialog, desktop Git client, or terminal.

Platform model

RefactorAI is organized around repositories, commits, and Refactor Requests. A repository has policy defaults. Each local commit creates a scoped review event. Actionable findings become requests that developers or agents resolve before push.

  1. Developers register at RefactorAI and generate developer keys.
  2. Teams install the CLI and hooks in repositories that accept AI-generated code.
  3. Developers keep refactor watch open while they work.
  4. Pre-push gates enforce configured policy before commits leave the machine.

Choose your onboarding path

Account bootstrap checklist

Developers should authenticate with a platform-issued key before enabling hooks. The CLI connects to the hosted API by default; only self-hosted deployments need a custom platform URL.

Developer account and key setup
# 1) Sign up at https://refactorai.codes
# 2) In the RefactorAI dashboard, create a Developer Key

refactor login --key <your_developer_key>
refactor whoami