79 lines
1.9 KiB
Markdown
79 lines
1.9 KiB
Markdown
# Guide for Installing and Using `z` on Debian-based Systems
|
|
|
|
`z` is a command-line tool that helps you track and jump to your most frequently used directories. This guide provides instructions for installing and using `z` on Debian-based systems like Ubuntu.
|
|
|
|
## Installation
|
|
|
|
### Step 1: Download the `z` Script
|
|
|
|
First, download the `z` script using `wget`:
|
|
|
|
```bash
|
|
wget https://raw.githubusercontent.com/rupa/z/master/z.sh -O ~/z.sh
|
|
```
|
|
|
|
This command saves the `z` script in your home directory.
|
|
|
|
### Step 2: Include the Script in Bash Configuration
|
|
|
|
Include the `z` script in your `.bashrc` file to ensure it's sourced every time a new shell session starts.
|
|
|
|
Open `.bashrc` with a text editor, for example:
|
|
|
|
```bash
|
|
nano ~/.bashrc
|
|
```
|
|
|
|
Add the following line at the end of the file:
|
|
|
|
```bash
|
|
. ~/z.sh
|
|
```
|
|
|
|
### Step 3: Reload Your Shell Configuration
|
|
|
|
To apply the changes, reload your `.bashrc`:
|
|
|
|
```bash
|
|
source ~/.bashrc
|
|
```
|
|
|
|
## Usage
|
|
|
|
After installing `z`, it will start tracking the directories you visit. The more you use it, the smarter it gets in predicting your navigation patterns.
|
|
|
|
### Basic Commands
|
|
|
|
- To jump to a directory: `z <part_of_directory_name>`
|
|
|
|
```bash
|
|
z project
|
|
```
|
|
|
|
This command will jump to a directory that matches 'project' in its path, based on your navigation history.
|
|
|
|
- To view the list of tracked directories: `z -l`
|
|
|
|
```bash
|
|
z -l
|
|
```
|
|
|
|
- To jump to a directory with a ranking above a specific threshold: `z -r <rank> <part_of_directory_name>`
|
|
|
|
```bash
|
|
z -r 10 project
|
|
```
|
|
|
|
- To jump to a directory accessed more recently than the given time: `z -t <part_of_directory_name>`
|
|
|
|
```bash
|
|
z -t project
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
- Ensure the `z.sh` script is correctly downloaded and the path in your `.bashrc` is correct.
|
|
- For more advanced usage or troubleshooting, visit the `z` project page on GitHub.
|
|
|
|
With `z`, you can significantly speed up your directory navigation in the terminal. Happy coding!
|