AI Agent (Ada)

How Ada, the in-browser AI coding assistant, reads, writes, and deploys code in your projects.

Overview

Ada is the AI coding agent built into every RubyOnVibes project. Ada can read your files, write code, run commands, check for errors, and deploy changes — all through a chat interface in the editor.

Under the hood, Ada runs Claude Code — Anthropic's agentic coding tool. The application template includes .claude/ configuration with hooks, commands, and settings optimized for the platform's agentic conventions, so Claude Code operates reliably within the structure of each generated app.

How It Works

  1. You type a message in the chat panel
  2. Ada processes the request with access to your full codebase
  3. For code changes, Ada invokes Claude Code, which reads your files, understands context, and proposes edits
  4. Changes stream back to your browser in real-time for review
  5. Approved changes are committed and auto-deployed

What Ada Can Do

Code

Capability Description
Write & edit files Create files, delete files, or make targeted edits to existing ones
Search code Semantic search (find by meaning) and pattern search (find by text)
Read & browse Read any file and navigate your project's directory structure
Review changes See diffs and pending code change suggestions
Git operations Commit, inspect history, view diffs
Manage dependencies Add, remove, or update Ruby gems and JavaScript packages

Run & Debug

Capability Description
Check for errors Unified error analysis across frontend, backend, and background jobs
Read logs Application logs from your running app in production
Run commands Execute shell commands, Rails console, or rake tasks on your deployed app
Health check Verify your app's backend is responding

Knowledge

Capability Description
Library docs Look up documentation for Ruby gems and npm packages

Extended Thinking

When using supported models, Ada can use extended thinking to reason through complex problems before responding. You'll see Ada's thinking process in the chat as it works through the problem.

Cancellation

You can cancel Ada mid-response. The active job is tracked and cancellation is checked at regular intervals during processing.

Auto-Recovery

Ada doesn't just build features — it also keeps your app healthy:

  • Boot failures — If your app crashes on startup, Ada diagnoses and fixes syntax or configuration errors
  • Migration errors — Failed database migrations can be detected and fixed automatically
  • Vite build failures — Frontend build errors caught and resolved
  • SSR build failures — Server-side rendering issues are diagnosed and repaired (this feature is gated)