🧭 dev — Personal IDE Launcher

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

---

🔧 Installation

$3

``bash
npm install -g dev-agent
`

Or use with npx without installing:
`bash
npx dev-agent
`

$3

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.

---

$3

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" }
}
}
`

---

$3

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
`

---

🚀 Usage

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

---

🧠 IDE Options

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 |

---

💡 Tips

- 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 ` as fallback.

---

$3

MIT