FsTag

FsTag is a utility command line interface for performing bulk operations on files.

Features

• Powerful file filtering and selection
• Flexible "session" functionality for managing specific groups of files
• Cross-platform compatibility for Windows, Mac, and Linux.

Installation

See versions and downloads in Releases.

Additionally, add the executable to your PATH

• on Windows
• on Mac
• on Linux

Basic Usage

The core functionality of the CLI is accessed via tagging:

> fstag test.txt
> fstag tag relative my/relative/file.md
> fstag tag glob **/*.cs

Wherein, files are selected relative to the current working directory using a filter.

All tagged files are stored in a session-specific index, which can be viewed with the print command:

> fstag print index
test.txt;

There is no limit to how many files can be tagged (besides disk space for the index file, of course).

Once ready to act on indexed files, the various bulk commands can be used:

• fstag bulk delete
• crickets chirp in the distance

For more details, run fstag bulk -h or see bulk_operations.md.

Sessions

A tag 'session' is simply a group of tagged files which can be switched between, like so;

> fstag session switch my_session

This will change the session to my_session, as well as create it if necessary. All operations which deal with tagging will be secluded to the current session.

Documentation

See FsTag/docs.

The CLI also offers these files via the fstag docs command.

> fstag docs filters
Filters are a powerful mechanism for file selection used in tagging. All filters...

Contribution

See Contributing.md.