Getting Started

Install & setup

Install the public CLI, authenticate against ReactorAI, and configure a developer-ready baseline without self-hosting infrastructure.

Time: 15 minAudience: External developers and tech leads

Prerequisites

Python 3.11+ for CLI usage
Git access to your source repositories
A ReactorAI account at reactorai.codes
Developer key generated in the ReactorAI dashboard

Install the CLI

Install the CLI once in your developer environment. No self-hosted runtime setup is required for external onboarding.

Install command

python -m pip install --upgrade refactor
refactor --help

Authenticate with a platform-issued key

Set the hosted platform URL and authenticate with the developer key issued from the ReactorAI dashboard.

Hosted platform authentication

# Generate your key in https://reactorai.codes dashboard
export REFACTOR_PLATFORM_URL=https://reactorai.codes
refactor login --key <your_developer_key>
refactor whoami

Apply a team baseline configuration

Use a shared refactor.consti baseline so every repository follows the same publish and gate defaults.

Hosted-mode configuration baseline

# refactor.consti
version: 1

settings:
  developer_key: ${REFACTOR_API_KEY}
  mode: cloud_managed
  provider: cloud
  model_id: managed-default
  publish_mode: pr_only
  gate_mode: strict

Validate your setup

Before sharing onboarding docs with your team, run a quick identity and environment validation.

Developer setup verification

refactor whoami
refactor config
refactor doctor