Rubynod AI
Open-source AI coding assistant for VS Code — agent chat, local codebase indexing, file edits with diff review, terminal tools, inline edit, and tab autocomplete. Runs on your machine with Ollama by default; OpenAI, Anthropic, and OpenRouter are optional.
GitHub repository · Report an issue
Features
- Agent chat — Agent, Plan, Ask, and Debug modes in the sidebar
- Chat history — Previous chats, New chat, per-workspace sessions
- Model picker — Ollama or cloud provider and model per message
- File tools — Read, write, search/replace, grep, glob; Accept/Reject diffs
- @ context — Files, folders, symbols, drag-and-drop, context chips
- Codebase index — Local semantic and full-text search; optional auto-inject
- Inline edit —
Cmd+K / Ctrl+K on the current selection
- Tab autocomplete — Optional ghost-text while you type
- MCP — Extra tools via
~/.rubynod/mcp.json
- Checkpoints — Save workspace state before agent edits
- Rules and skills —
AGENTS.md, .rubynod/rules/, .rubynod/skills/
Platforms: macOS, Windows, Linux
Important: extension + AI service
Installing from the Marketplace gives you the VS Code UI only. Rubynod also needs a small AI service from the same repo (agent loop, tools, indexing) and usually Ollama for local models.
Extension → AI service (:3847) → Ollama (:11434) or cloud API
Quick setup (Marketplace install)
1. One-time: clone and build the AI service
git clone https://github.com/rohitpatil7892/rubynod.git
cd rubynod
# macOS: Node 22 recommended (avoid Node 25 for native modules)
export PATH="/opt/homebrew/opt/node@22/bin:$PATH"
npm install
npm run build
2. Point the extension at the repo
- Open VS Code Settings (
Cmd+,)
- Search
rubynod.ai.repoPath
- Set the path to your
rubynod clone (e.g. ~/Desktop/myCode/rubynod)
3. Start services
Terminal A — AI service (keep running):
cd /path/to/rubynod
npm run start:ai
Terminal B — Ollama (if using local models):
ollama serve
ollama pull qwen2.5-coder
4. In VS Code
- Command Palette → Rubynod: Start AI Service (first time may confirm repo path)
- Open the Rubynod AI activity bar icon → Chat
- Set Provider to Ollama and pick a model (e.g.
qwen2.5-coder for file tools)
- Use Ask for questions; Agent when you want edits
Keyboard shortcuts
Cmd+L / Ctrl+L — open chatCmd+K / Ctrl+K — inline edit on selection
Commands
- Rubynod: Open Chat — focus the chat sidebar
- Rubynod: New Chat — start a new conversation
- Rubynod: Start AI Service — start or configure the local AI service
- Rubynod: Clear Chat History — clear all chats for this workspace
- Rubynod: Build Codebase Index — rebuild the local code index
- Rubynod: Select Ollama Model — pick default Ollama model
- Rubynod: Add to Chat — add file or selection from explorer
- Rubynod: Inline Edit — edit selection with AI
- Rubynod: Open Settings — jump to Rubynod settings
Settings (common)
rubynod.ai.repoPath — path to cloned rubynod repo (AI service)rubynod.ai.serviceUrl — AI service URL (default http://127.0.0.1:3847)rubynod.models.provider — ollama, openai, anthropic, or openrouterrubynod.models.chatModel — default chat/agent modelrubynod.chat.defaultMode — agent, plan, ask, or debugrubynod.index.autoInjectContext — auto-attach indexed code to prompts
Search rubynod in Settings for the full list.
Requirements
- VS Code 1.85+
- Node.js 20 or 22 — for the AI service (not bundled in the VSIX)
- Ollama (recommended) — local LLMs at
http://127.0.0.1:11434
- ripgrep (
rg) — agent search (install)
Troubleshooting
- AI offline — run
npm run start:ai or Rubynod: Start AI Service
fetch failed — AI service not running on port 3847- Duplicate
rubynod.chatView — disable Marketplace or dev copy in Extensions
- Agent writes wrong files — use Ask for how-to; use qwen2.5-coder in Agent mode
- Empty file after write — update extension; use a tool-capable model
- Tab complete: model required — set
rubynod.models.chatModel or rubynod.tab.model
Documentation
Full docs live in the GitHub repo:
License
MIT — see LICENSE in the repository.
