A lightweight local agent that maps project aliases to filesystem paths and opens them in your chosen IDE
npm install tiniest-dev-agentA lightweight CLI tool to open your projects by alias, instantly, in your favorite IDE.
Type dev gw-client and jump straight into your workspace — no hunting through folders.
---
``bash`
npm install -g dev-agent
Or use with npx without installing:
`bash`
npx dev-agent
Create a personal bin folder and place the script there:
`bash`
mkdir -p ~/bin
curl -o ~/bin/dev https://raw.githubusercontent.com/diegoferreyra/dev-command/main/dev
chmod +x ~/bin/dev
Make sure your shell can find it:
`bash`
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
You can also symlink to /usr/local/bin/dev or /opt/homebrew/bin/dev if you prefer.
---
Create a file called ~/.dev-locations.json:
`bash`
nano ~/.dev-locations.json
Example:
`json`
{
"ide": "app:Cursor",
"aliases": {
"gw-lms": { "folder": "~/WebDevelopment/greenwave/greenwave-lms" },
"gw-client": { "folder": "~/WebDevelopment/greenwave/greenwave-client" },
"gw-commhub":{ "folder": "~/WebDevelopment/greenwave/greenwave-comm-hub" },
"gw-api": { "folder": "~/WebDevelopment/greenwave/greenwave-api" },
"gw-search": { "folder": "~/WebDevelopment/greenwave/greenwave-search-api" }
}
}
---
If you want to keep your config somewhere else, export a DEV_CONFIG variable:
`bash`
export DEV_CONFIG="$HOME/dev-locations.json"
Add it permanently to your shell config if you like:
`bash`
echo 'export DEV_CONFIG="$HOME/dev-locations.json"' >> ~/.zshrc
---
| Command | Description |
|----------|-------------|
| dev | Opens the alias folder in your configured IDE |dev
| | Opens multiple aliases (each in a new window) |dev --list
| | Lists all known aliases |dev --config
| | Prints the active config file path |
Example session:
`bash`
dev gw-client
dev gw-client gw-api gw-search
dev --list
Each alias opens in a separate window of your IDE.
---
The "ide" key in your config defines how projects open:
| Value | Behavior |
|--------|-----------|
| "cursor" | Uses the Cursor CLI (cursor -n ) |"code"
| | Uses the VS Code CLI (code -n ) |"app:Cursor"
| | Opens the macOS app Cursor |"/absolute/path/to/binary"
| | Uses a direct path to your IDE binary |
---
- Make sure your IDE's CLI command is available in your PATH.
- Supports multiple aliases per run.
- Works with Cursor, VS Code, and any macOS app name.
- Uses open -n -a
---
MIT