findertags

Manage macOS Finder tags on files and directories from the command line.

10|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/Aayush9029/homebrew-tap --skill findertags
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findertags
Source: https://github.com/Aayush9029/homebrew-tap/tree/main/skills/findertags
Command: npx skills add https://github.com/Aayush9029/homebrew-tap --skill findertags

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read, add, remove, replace, and clear macOS Finder tags on files and directories from the command line. Use when the user wants to organize files with color tags, query which tags are on a path, bulk-tag project folders, or list tag frequencies across a directory tree.

Core Features & Use Cases

  • Read tags for one or more paths
  • Add or replace tags on a path
  • List tag frequencies across paths

Quick Start

Invoke the finder-tags CLI to inspect or modify tags on one or more paths with the read, add, remove, or clear commands.

Frequently Asked Questions about findertags

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage macOS Finder tags from the command line?

You can manage macOS Finder tags from the command line by using a CLI with subcommands to read, add, remove, replace, and clear tags on files and directories. It supports options like --verbose and --format json for output.

Can I bulk-tag project folders with color tags in macOS?

Yes, you can bulk-tag project folders with color tags in macOS by passing multiple paths to the CLI's add or write subcommands, applying or replacing Finder tags across entire directory trees.

How do I list Finder tag frequencies across a directory tree?

You list Finder tag frequencies across a directory tree by invoking the list subcommand, which scans paths and outputs tag counts, optionally formatted as JSON for programmatic use.

Does this CLI tool output Finder tags in JSON format?

Yes, the CLI outputs Finder tags in JSON format when you pass the --format json option, allowing you to query tags on paths and parse the results in scripts or pipelines.

What is the best way to query which color tags are on a file path?

The best way to query which color tags are on a file path is to use the read subcommand, which retrieves and displays the current macOS Finder tags applied to the specified file or directory.

How do I clear all tags from a file or directory in macOS?

You clear all tags from a file or directory in macOS by using the clear subcommand, which removes every Finder tag from the specified path in a single operation.