A terminal directory navigator. Browse your filesystem interactively and cd into any folder without typing paths.

---

Preview

---

Installation

Linux

curl -sSL https://raw.githubusercontent.com/Gorgoll/cdg/main/install.sh | bash
source ~/.bashrc

This will:

• Download the cdg binary to ~/.local/bin/
• Add the cdg shell function to your ~/.bashrc or ~/.zshrc

Windows

irm https://raw.githubusercontent.com/Gorgoll/cdg/main/install.ps1 | iex

This will:

• Download the cdg binary to $env:LOCALAPPDATA\cdg\cdg.exe
• Add the cdg shell function to your PowerShell profile

macOS

⚠️ macOS builds are available on the releases page but are untested.

Download the binary manually and follow the Manual Installation steps below.

---

Usage

Just run:

cdg

Key	Action
↑ / ↓	Navigate folders
Enter	Enter selected folder
../	Go to parent directory
./	cd into current directory and quit

---

Manual Installation

1. Download the binary for your platform from the releases page.
2. Place it at ~/.local/bin/cdg-bin (or anywhere on your $PATH).
3. Add the following function to your shell config:

bash/zsh (~/.bashrc or ~/.zshrc):

cdg() {
    local dir
    dir=$(~/.local/bin/cdg-bin 2>/dev/tty)
    [ -n "$dir" ] && cd "$dir"
}

PowerShell (your PowerShell profile):

function cdg {
    $dir = (& "$env:LOCALAPPDATA\cdg\cdg.exe").Trim()
    if ($dir) { Set-Location $dir }
}

4. Reload your shell:

# bash/zsh
source ~/.bashrc

# PowerShell
. $PROFILE

---

Platform Support

Platform	Status
Linux	✅ Tested
Windows	✅ Tested
macOS	⚠️ Untested