# QuickFind

Terminal utility for instant directory bookmarking

Canonical URL: https://kb.byaditya.com/entry/docs/dev/quickfind
Source: https://docs.adityabaindur.com/docs/dev/quickfind
Source updated: 2026-07-18T01:34:51Z
Indexed: 2026-11-05T03:56:29.576Z

---

## Overview

A lightweight terminal utility for bookmarking directories and jumping to them instantly. Navigate large codebases and complex folder structures with single commands.

### [GitHub](https://github.com/Aditya-Baindur/quickFind)

## Features

- Save directory bookmarks with short aliases
- Jump to bookmarked directories from anywhere
- Cross-session persistence (survives terminal restarts)
- Shell-agnostic implementation
- Lightweight—single compiled binary
- Zero background processes or daemons
- Perfect for large codebases and monorepos
- Instant path resolution with minimal overhead

## Architecture

**Lightweight and Simple**:

- **CLI**: `quickfind` binary with subcommands (init, rmv, list, cd)
- **Shell Integration**: `qfcd()` function enables seamless directory jumping
- **Data Storage**: Local file at `~/.quickfind`
- **System Integration**: Profile script at `/etc/profile.d/qfcd.sh` for automatic loading
- **Cross-Shell**: Works with all POSIX-compatible shells (bash, zsh, sh, ksh, fish)

## Installation

```bash
# Via Homebrew (recommended)
brew tap Aditya-Baindur/homebrew-quickfind
brew install quickfind

# Or manually
git clone https://github.com/Aditya-Baindur/quickFind
cd quickFind
make install
```

Then source the profile script:

```bash
source /etc/profile.d/qfcd.sh
```

## Usage

```bash
# Save current directory as 'project'
quickfind init project

# Jump to 'project' from anywhere
qfcd project

# List all bookmarks
quickfind list

# Remove a bookmark
quickfind rmv project
```

## Tech Stack

- POSIX Shell
- Compiled Binary
- Make
- Homebrew