VibeRails

VibeRails is an opinionated framework that helps keep AI coding assistants from going off the rails.

Live Site: https://viberails.ai/

Overview

• Environment Isolation - Like Conda for LLMs. Create separate environments to experiment with Claude, Codex, or Antigravity settings without breaking your primary setup
• Cross-LLM Learning - Share context and learnings between different LLM providers (Claude, Codex, Antigravity)
• RAG (Without The Rot) For Your Code - Track things like repeated fixes the LLM forgets, including when you have to tell it the same thing 6 or 7 times in one session and it still doesn't understand, how you describe a feature and where that code lives, and file change summaries with commits, then only provide what’s useful at call time to prevent context rot.
• Few Shot Prompting - Get Antigravity or codex to code like Claude for code that has been done before with few shot prompting... Making them up to 20% better (research paper and eval data coming soon.)
• Rule Enforcement - Define and enforce coding standards like test coverage, cyclomatic complexity, logging practices, and more. LLMs fix their errors before code can be pushed or before the tech debt get astronomical.
• Token Savings - Learn your codebase and how you describe it, providing LLMs with smart file hints to reduce token usage and costs
• AGENTS.md Management - Create and manage agent instruction files following the agents.md specification
• Web Terminal - Launch CLIs directly in the browser with xterm.js. Select base CLIs (Claude, Codex, Antigravity) or custom environments from a visual dropdown with optgroups

Status

• This repo is a lightweight, local-focused version of my personal setup. I'm stripping out multi-GPU/cluster support, heavy eval tooling, and other framework dependencies so it runs fast with Claude, Codex, and Antigravity CLIs. I'm rebuilding it around the features I think most people will actually want for local workflows.

Quick Start

Prerequisites

For End Users:

• Just install from VS Code Marketplace... That's it
• One or more LLM CLIs: Claude CLI, OpenAI Codex, or Google Antigravity CLI (agy)
• No other dependencies required - backend binaries are installed automatically on first run

For Contributors (Working on the Project):

• .NET 10.0 SDK or later (required to build the backend)
• Node.js 20+ (required to build the VS Code extension)
• Git
• VS Code 1.85.0 or later

Installation

Build backend

# Clone the repository
git clone https://github.com/robstokes857/vibe-rails.git
cd vibe-rails

# Build and run
cd VibeRails
dotnet run

The dashboard will open in your default browser at http://localhost:{port 5000-5999}.

Option 2: VS Code Extension

# Navigate to extension directory
cd vscode-viberails

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Open in VS Code
code .

Web Terminal Features

The integrated Web UI terminal lets you interact with LLM CLIs directly in your browser:

Key Features

• Launch Claude, Codex, or Antigravity CLIs in a browser-based terminal (xterm.js)
• Select from custom environments in a visual dropdown (Base CLIs vs Custom Environments)
• Auto-populate environment settings (custom args, prompts, model configs)
• Navigate from Environment Management → Dashboard with environment pre-selected
• Real-time CLI output with proper Unicode and color support
• PTY-backed sessions with full shell capabilities

Usage

Standard Launch:

1. Go to Dashboard
2. Scroll to Terminal section
3. Select a CLI or custom environment from dropdown
4. Click "Start" to launch

Quick Launch from Environments:

1. Go to Environments page
2. Click "Web UI" button next to any environment
3. Dashboard opens with terminal section visible
4. Environment is pre-selected in dropdown
5. Click "Start" to launch with environment config applied

Environment Integration

When you select a custom environment in the terminal:

• The backend automatically applies your custom args (e.g., --verbose, --sandbox)
• Your custom prompt is injected at session start
• Model-specific settings are configured (Claude model, Codex sandbox mode, etc.)
• The environment's "Last Used" timestamp is updated

This gives you quick access to different configurations without remembering command-line flags!

Version: 1.1.5
Last Updated: 2026-02-05
Maintained By: Robert Stokes