https://github.com/harehare/arrow
arrow is a CLI tool specialized for moving directories that can be used as a cd replacement.
https://github.com/harehare/arrow
change-directory cli terminal
Last synced: 5 months ago
JSON representation
arrow is a CLI tool specialized for moving directories that can be used as a cd replacement.
- Host: GitHub
- URL: https://github.com/harehare/arrow
- Owner: harehare
- License: mit
- Created: 2023-11-05T13:47:16.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-08-12T06:00:29.000Z (5 months ago)
- Last Synced: 2025-08-12T08:11:35.134Z (5 months ago)
- Topics: change-directory, cli, terminal
- Language: Go
- Homepage:
- Size: 167 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🔛 arrow
[](http://opensource.org/licenses/MIT)
arrow is a CLI tool specialized for moving directories that can be used as a `cd` replacement.
To move directories, simply use the up, down, left, and right arrow keys to select the directory and press the Enter key.
## Install
```bash
$ go install github.com/harehare/arrow@latest
```
### Zsh
```bash
function ao() {
cd $(arrow --icons)
}
```
## Usage
| Key binding | Description |
| ------------ | -------------------------------------------- |
| `Up`, `Down` | Move cursor |
| `Right` | Move directory |
| `Enter` | Select directory |
| `Shift+Down` | Change order (directory name, modified time) |
| `Ctrl+c` | Exit |
```
USAGE:
arrow [options]
OPTIONS:
--all, -a Show hidden files. (default: false)
--icons, -i Display icons. (default: false)
--query value, -q value Specifies a query to search the directory.
--help, -h show help
--version, -V print only the version (default: false)
```
## Customization
ANSI 256 Colors or HEX
```bash
export ARROW_BORDER_COLOR="80"
export ARROW_CURRENT_DIRECTORY_COLOR="57"
export ARROW_CURSOR_COLOR="57"
export ARROW_DISABLED_COLOR="240"
export ARROW_FOREGROUND_COLOR="#009CD1"
export ARROW_HIGHLIGHT_COLOR="80"
export ARROW_PROMPT_COLOR="36"
export ARROW_SYMLINK_COLOR="36"
```
## Run
```sh
just run
```
## License
MIT