Documentation

Installation

Download Ragtoolina for macOS from ragtoolina.com. Open the .dmg file and drag Ragtoolina to your Applications folder. Launch the app and sign in with your account.

Creating Your First Index

Once signed in, click "New Index" and select a project directory. Ragtoolina will scan your codebase and generate semantic embeddings. This typically takes a few minutes depending on project size.

Overview

Ragtoolina exposes an MCP (Model Context Protocol) server that AI coding tools can connect to natively. This is the primary way to use Ragtoolina with tools like Claude Code and Cursor.

Setup

The MCP server starts automatically when Ragtoolina is running. Configure your AI tool to connect to the local MCP endpoint. For Claude Code, add the server to your claude_desktop_config.json. For Cursor, add it to .cursor/mcp.json.

Available Tools

• search_codebase — Semantic search across your indexed projects
• find_symbol — Find functions, classes, and types by name
• get_symbol_tree — Get the structure of a file
• find_references — Find all usages of a symbol
• read_file — Read a file with semantic context

GitHub

Connect your GitHub account to index repositories directly from the cloud. Supports both public and private repositories, including GitHub Enterprise. Changes are synced automatically.

Jira

Index Jira issues and comments alongside your code. Useful for giving AI tools context about requirements, bug reports, and feature specifications.

Confluence

Index Confluence pages and spaces. Technical documentation, architecture decisions, and team knowledge become part of your AI's context.

Azure DevOps

Connect Azure DevOps repositories and work items. Supports both Git repos and boards.

Creating a Team

Teams allow multiple developers to share a single semantic index. Create a team from the web dashboard and invite members by email.

Team Indexes

Team indexes are shared across all members. When one member updates the index, everyone gets the latest context. Admins can manage which repositories and integrations are included.

Roles

• Owner — Full control over team settings, billing, and members
• Admin — Can manage indexes, integrations, and invite members
• Member — Can use team indexes and view team content

Overview

The Ragtoolina API is available at api.ragtoolina.com. All endpoints require authentication via Bearer token. The API follows REST conventions and returns JSON responses.

Authentication

Obtain an API token from your account settings in the web dashboard. Include it in the Authorization header: Bearer <your-token>.