agentide

ghatdev/agentide

3.2

If you are the rightful owner of agentide and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

AgentIDE is a Rust-based CLI tool that provides AI agents with deep workspace intelligence through the Model Context Protocol (MCP).

Tools
5
Resources
0
Prompts
0

AgentIDE

Terminal-first IDE delivering RAG, indexing, and workspace intelligence to AI agents

What is AgentIDE?

A Rust-based CLI tool that gives AI agents deep workspace intelligence through the Model Context Protocol (MCP). Features intelligent code indexing, semantic search, LSP integration, session memory, and knowledge management.

Quick Start

Installation

Option 1: Install from Git (recommended)

cargo install --git https://github.com/ghatdev/agentide

Option 2: Install from crates.io (coming soon)

cargo install agentide

Option 3: Build from source

git clone https://github.com/ghatdev/agentide
cd agentide
cargo build --release
# Binary at: target/release/agentide

Build Requirements:

  • Rust 1.70+
  • protobuf-compiler - Required at build time by LanceDB dependency
    • Ubuntu/Debian: apt install protobuf-compiler
    • macOS: brew install protobuf

Initialize Workspace

cd /path/to/your/project
agentide init
agentide index

Creates:

  • agentide.toml - Workspace configuration (at root)
  • .agentide/agentide.db - SQLite FTS5 database
  • .agentide/embeddings/ - LanceDB vector store

Features

25+ CLI Commands

Workspace: init, status, file-tree, index

Search: search, search-regex, search-semantic, search-docs

Knowledge: Documentation and agent memory management

LSP: Language server lifecycle management (lsp start/stop/status/logs)

Symbols: symbols find, symbols references

Git: git-status, git-diff

Planning: workflow, plan, todos - Session-based task management with approval workflows

37 MCP Tools

Configure in Claude Desktop (~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "agentide": {
      "command": "/path/to/agentide",
      "args": ["mcp"],
      "cwd": "/path/to/workspace"
    }
  }
}

Tool Categories:

  • Workspace (2) - Status, file tree
  • Search (5) - FTS5, regex, semantic, hybrid, docs
  • Symbol Editing (5) - Find, replace, insert before/after
  • Code Analysis (2) - File structure, diagnostics
  • Knowledge (4) - Create, update, list, search
  • Agent Lifecycle (5) - Sessions, insights, linking
  • Planning (6) - Workflows, plans, todos
  • RAG (1) - Embedding stats
  • Smart Context (1) - Intelligent context gathering

See

Technology Stack

  • SQLite FTS5 - Full-text search indexing
  • Tree-sitter - 40+ language parsing
  • FastEmbed - Local semantic embeddings (BGE-Small-EN-v1.5)
  • LanceDB - Vector storage for similarity search
  • Tower-LSP - Language server protocol integration

Usage

# Search code
agentide search "authenticate"
agentide search-semantic "user login flow"

# Task management
agentide workflow status
agentide plan list
agentide todos list --status pending

# Knowledge management
agentide knowledge create --title "API Design" --content "..."
agentide knowledge search "authentication"

# LSP operations
agentide lsp start rust
agentide symbols find AuthService
agentide diagnostics --file src/auth.rs

# Embeddings
agentide embed
agentide embedding-stats

Configuration

Example agentide.toml:

[workspace]
name = "My Project"

[repositories]
paths = ["."]
exclude_patterns = ["node_modules/", "target/", ".git/"]

[rag]
auto_index = true
auto_embedding = true

[[lsp.servers]]
language = "rust"
command = "rust-analyzer"
auto_start = true

[mcp_tools]
workspace = true
search = true
symbol_editing = true
knowledge = true
agent_lifecycle = true
smart_context = true

Project Structure

crates/
├── agentide/          # CLI binary & HTTP server (thin adapters)
├── agentide-core/     # Business operations (search, workflow, knowledge, etc.)
├── agentide-mcp/      # MCP server & 31 tools (thin wrappers)
├── agentide-parser/   # Tree-sitter parsing & code chunking
├── agentide-lsp/      # LSP client protocol
├── agentide-store/    # SQLite FTS5 + LanceDB (pure CRUD)
├── agentide-grammars/ # 44 native grammars + WASM support
└── agentide-types/    # Domain types + storage traits

Documentation

  • - Workflows and CLI reference
  • - MCP configuration
  • - Quick reference for AI agents

Development

# Build
cargo build --release

# Test
cargo test

# Run specific tests
cargo test --package agentide --test integration_tests
cargo test --package agentide --test mcp_unit_tests

License

MIT OR Apache-2.0

Links

Built for AI-assisted development