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

$3

``bash
npx agent-ide [options]
`

From source:

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

$3

In Claude Code conversation:

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

Or from terminal:

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

$3

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

`markdown


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

$3

| 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 |

$3

| 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