Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Investigate wtf you were working on... where is that damn file?

Project Description

catscan, or mindgrep

Forgot where you put that file? Forgot what you were working on?

Wish you could grep against a file you forgot about?


From the project root directory::

$ pip install catscan


$ python install


Simply run it with something that might be in the file, and it will check through files you worked with in your bash history::

# Find files you worked on that have the search string 'install' in them.
$ catscan 'install'

Use --help/-h to view info on the arguments::

$ catscan --help

More complex scan behavior is also available::

# search using regex (python format)
$ catscan -r '201[56]-\d+-\d+'

# limit to files less than 1 megabyte
$ catscan -m 1 'foo'

# limit to files less than ~100 kilobytes
$ catscan -m 0.1 'foo'

# case insensitive search
$ catscan -i 'foo'

# Look for files that are not necessarily ASCII (using file magic)
$ catscan -a 'CAFEBABE'

# Quit after finding the first matching file
$ catscan -q 1 'foo'

Release Notes

Removed start/end features to simplify runtime requirements
bugfree (enough) version for release
Finished main features
Project created

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(6.9 kB) Copy SHA256 Hash SHA256
Source None Feb 5, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting