Agent IDE

Minimize tokens, maximize accuracy for AI Agents

Code intelligence toolkit designed for AI agents, providing search, refactoring, and dependency analysis capabilities.

Features

• Parser: TypeScript / JavaScript
• Unicode identifiers: Supports non-ASCII variable names
• Glob patterns: move supports *.ts, **/*.ts, etc.
• Output formats: --format json | summary | diff

Quick Start

CLI Usage

npx agent-ide <command> [options]

From source:

git clone https://github.com/vivalalova/agent-ide.git
cd agent-ide
pnpm install && pnpm build && npm link

Claude Code Plugin Installation

In Claude Code conversation:

/plugin marketplace add vivalalova/agent-ide
/plugin install agent-ide@agent-ide-skills

Or from terminal:

claude plugin marketplace add vivalalova/agent-ide
claude plugin install agent-ide@agent-ide-skills

Recommended: Add to CLAUDE.md

To help Claude Code automatically use agent-ide when appropriate, add the following to your ~/.claude/CLAUDE.md:

## Agent IDE Integration

Use the `agent-ide` skill for TS/JS code intelligence operations. **Prefer agent-ide over manual Edit/Grep** for:

| Operation | Command | Instead of |
|-----------|---------|------------|
| Rename symbol | `/agent-ide rename` | Multiple Edit calls |
| Move file/member | `/agent-ide move` | Write + Delete + Edit imports |
| Find references | `/agent-ide find-references` | Grep + manual filtering |
| Detect dead code | `/agent-ide deadcode` | Manual analysis |
| Analyze impact | `/agent-ide impact` | Manual tracing |
| Check cycles | `/agent-ide cycles` | Manual dependency review |
| Function refactor | `/agent-ide change-signature` | Multiple Edit calls |
| API snapshot | `/agent-ide snapshot` | Multiple Read calls |
| Undo changes | `/agent-ide undo` | Manual revert |

**Trigger keywords**: rename, move file, move function, find references, dead code, unused code, circular dependency, call hierarchy, refactor parameters, impact analysis

**Benefits**: Automatic reference updates, atomic operations, zero missed references, undo support

Commands

Query (Read-only)

| Command | Description | | ----------------- | -------------------------------------- | | cycles | Detect circular dependencies (Tarjan) | | impact | Analyze change impact range (BFS) | | snapshot | Generate module API snapshots | | find-references | Find symbol definitions and references | | call-hierarchy | Analyze function call hierarchy | | deadcode | Detect unused code |

Mutation (supports --dry-run)

| Command | Description | | ------------------ | ------------------------------------------------ | | rename | Rename symbols and update all references | | change-signature | Refactor function parameters (reorder/add/remove)| | move | Move files/directories and update imports | | move (with line) | Move members across files (path:line syntax) |

Documentation

• Command Reference - Quick reference for all commands

License

MIT