Installation

Requirements

Node.js 22+ (LTS recommended)
pnpm, npm, or yarn
Cursor or Claude Code (for MCP integration)

Install dev-agent

npm:


npm install -g @lytics/dev-agent

pnpm:


pnpm add -g @lytics/dev-agent

yarn:


yarn global add @lytics/dev-agent

Verify the installation:


dev --version

Setup for Cursor

1. Index your repository

Navigate to your project and index it:


cd /path/to/your/project
dev index .

This creates a local vector database in ~/.dev-agent/indexes/.

2. Install MCP integration


dev mcp install --cursor

This configures Cursor to use dev-agent’s MCP server.

3. Restart Cursor

Restart Cursor to pick up the new MCP configuration.

4. Verify it works

In Cursor’s AI chat, ask:

“Use dev_search to find authentication code”

If dev-agent is working, you’ll see semantic search results from your codebase.

Setup for Claude Code

1. Index your repository


cd /path/to/your/project
dev index .

2. Install MCP integration


dev mcp install

3. Restart Claude Code

The MCP tools should now be available in Claude Code.

Configuration

dev-agent stores its data in ~/.dev-agent/:


~/.dev-agent/
├── indexes/           # Vector databases (per-repo)
├── github/            # GitHub metadata cache
└── config.json        # Global configuration (optional)

Note: Each repository gets its own index. Indexes are keyed by the repository’s absolute path.

Troubleshooting

”Command not found: dev”

Make sure npm’s global bin is in your PATH:


# Check where npm installs global packages
npm config get prefix
 
# Add to PATH (add to ~/.zshrc or ~/.bashrc)
export PATH="$(npm config get prefix)/bin:$PATH"

MCP tools not showing in Cursor

Check the MCP configuration:
```
dev mcp list --cursor
```
Verify your repository is indexed:
```
dev status
```
Restart Cursor completely (not just reload window)

Index errors

If indexing fails, try:


# Clean and re-index
dev clean
dev index .