Docs
Search docs… ⌘K
← Back to site Download

Settings

Configure every aspect of VibeRails — from CLI tool connections and default AI models to review behaviour and application preferences.

Overview

The Settings screen is accessible from the sidebar gear icon or via Cmd + ,. It is organised into logical sections so you can quickly find and adjust the option you need.

Settings screen showing all configuration sections
The Settings screen groups options into CLI Status, Review Config, Fix Config, and General sections.

CLI Status

VibeRails requires at least one AI CLI tool installed on your system. The CLI Status section shows the detection state of each supported tool:

CLI Tool Status Indicator Notes
Claude Code Green check or red cross Detected via claude on your PATH. Required for Claude-based reviews.
Codex CLI Green check or red cross Detected via codex on your PATH. Required for OpenAI-based reviews.
Tip: If a CLI tool is installed but not detected, make sure it is available in the shell that launched VibeRails. You can verify by running which claude or which codex in your terminal.

Review Configuration

These settings control the default behaviour when starting a new code review session:

Setting Description Default
Default CLI Which CLI tool to pre-select in the review wizard. Claude Code
Default Model The AI model pre-selected for new reviews. Sonnet 4
Max File Size Files larger than this threshold are excluded from review scans. 100 KB
Exclusion Patterns Glob patterns for files and directories to always skip (e.g. node_modules, dist). Common defaults

Fix Configuration

Fix sessions have their own set of defaults:

Setting Description Default
Default Fix CLI CLI tool pre-selected when starting a fix session. Claude Code
Default Fix Model AI model pre-selected for fix sessions. Sonnet 4
Auto-stage Changes Whether to automatically git add fixed files. Off

Guided Tour

VibeRails includes an interactive guided tour that walks you through the main interface on first launch. If you dismissed it and want to revisit, you can re-trigger the tour from the Settings screen.

Tip: The tour is a great way to onboard new team members. Share a screen and walk through the tour together to get everyone up to speed quickly.

General Preferences

Additional application-wide settings:

  • Theme — VibeRails uses a dark theme by default. Future releases may add a light theme option.
  • Data Directory — The path where VibeRails stores project data and reviews. Displayed read-only for reference.
  • Version — The currently installed version of VibeRails, with a link to release notes.