Getting Started

Create your first project

Connect your repository in ReactorAI, run your first CLI review, and confirm artifact visibility in the hosted dashboard.

Time: 12 minAudience: External developers and repository maintainers

1) Create the project in ReactorAI

A project stores repository identity, branch defaults, and governance policy. External developers should use the ReactorAI dashboard for this step.

Project creation checklist
# In https://reactorai.codes:
# 1) Create a new project
# 2) Connect your Git provider account
# 3) Select repository + default branch
# 4) Save policy defaults (recommend pr_only + strict gate)

2) Run your first local review workflow

Clone the same repository locally and run Refactor commands. This creates the first run artifacts linked to your hosted project.

First run commands
git clone https://github.com/<your-org>/<your-repo>.git
cd <your-repo>

refactor init
refactor review .
refactor code .
refactor status

3) Validate results before publishing

Before opening a pull request, inspect proposed diffs and run strict checks to prevent policy or secret violations.

Pre-publish checks
# Optional pre-publish quality checks
refactor diff
refactor check --strict

4) Review artifacts in the dashboard

  • Findings by category and severity
  • Patch groups and generated tests
  • Gate outcomes and publish readiness
  • Approval/rejection timeline by role

After first-run success, move to Developer Workflow for a repeatable day-to-day process.