Skip to content

divpreeet/whereisthis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Apr 22, 2026
0cb63af · · Apr 22, 2026

History

11 Commits
Apr 21, 2026
Apr 22, 2026
Apr 22, 2026
Apr 21, 2026
Apr 22, 2026
Apr 22, 2026

Repository files navigation

whereisthis

a human language based file finder with a tui using textual!

installation

currently, there is a macos homebrew release, and a pip version for windows and linux!

macos

make sure you have homebrew installed (install at https://brew.sh)!

then, simple tap into the repo and install!

brew tap divpreeet/whereisthis
brew install whereisthiss

then just type whereisthis to run!

windows and linux

currently, the only 'easy' way to install on windows and linux is using pip, so make sure you have python installed!

create a venv

windows -

python -m venv venv
venvv\Scripts\Activate.ps1

linux -

python3 -m venv venv

source venv/bin/activate

then install using -

pip install whereisthis

and just run using whereisthis!

usage

whereisthis [query] [options]

both, the query and options are optional, it just helps you kickstart!

options

  • --dir [path] - specify the directory to search in - whereisthis --dir ~/Documents, the default directory is the current directory.
  • --hidden - search through hidden files, by default hidden files are ignored!

About

a CLI file search tool that understands human language!

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages