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