🧭 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

Option 1: Install via npm (Recommended)

npm install -g dev-agent

Or use with npx without installing:

npx dev-agent <alias>

Option 2: Manual Installation

Create a personal bin folder and place the script there:

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:

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 your configuration file

Create a file called ~/.dev-locations.json:

nano ~/.dev-locations.json

Example:

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

4. (Optional) Custom config path

If you want to keep your config somewhere else, export a DEV_CONFIG variable:

export DEV_CONFIG="$HOME/dev-locations.json"

Add it permanently to your shell config if you like:

echo 'export DEV_CONFIG="$HOME/dev-locations.json"' >> ~/.zshrc

🚀 Usage

| Command | Description | |----------|-------------| | dev <alias> | Opens the alias folder in your configured IDE | | dev <a1> <a2> ... | Opens multiple aliases (each in a new window) | | dev --list | Lists all known aliases | | dev --config | Prints the active config file path |

Example session:

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 <folder>) | | "code" | Uses the VS Code CLI (code -n <folder>) | | "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 <AppName> as fallback.

License

MIT