LOCALSEARCH-TAG(1)            LocalSearch manual            LOCALSEARCH-TAG(1)

NAME
       localsearch-tag - Add, remove and list tags.

SYNOPSIS
       localsearch tag FILE [-l <limit>] [-o <offset>] [-r]
       localsearch tag -t [-s] [-r] FILE
       localsearch tag -a <TAG> [-e <description>]
       localsearch tag -d <TAG>

DESCRIPTION
       List tags for local files or by the tag labels themselves if -t is
       used.

       It's also possible to manage tags with the -a and and -d options.

       The FILE argument can be either a local path or a URI. It also does not
       have to be an absolute path.

OPTIONS
       -t, --list
           List all tags. Results include the number of files associated with
           that tag and the tag's unique identifier. You can show the files
           associated with each tag by using --show-files.

       -s, --show-files
           Show the files associated with each tag. This option is ONLY
           available WITH the --list option.

       -a, --add=TAG
           Add a tag with the name TAG. If no FILE argument is specified, the
           tag is simply created (if it didn'talready exist) and no files are
           associated with it.

       -d, --delete=TAG
           Delete a tag with the name TAG. If no FILE argument is specified,
           the tag is deleted for ALL files.

       -e, --description=STRING
           This option ONLY applies when using --add and provides a
           description to go with the tag label according to STRING.

       -l, --limit=N
           Limit search to N results. The default is 512.

       -o, --offset=N
           Offset the search results by N. For example, start at item number
           10 in the results. The default is 0.

           $ localsearch tag -s -t banana

       Should show files in the database that have both the banana tag.

SEE ALSO
       localsearch search(1), localsearch info(1).

  3.11.2                          09/01/2026                LOCALSEARCH-TAG(1)