# Macos Tag Manager

> Automate and customize macOS Finder tags for organizing home-directory files using the macos-tag-manager repository. Use when setting up or tweaking semantic tagging with tagger.sh, running smart_organize.sh for frequency-based emoji tags, or documenting/installing prerequisites (Homebrew + tag utility). Use when this capability is needed.

- Skill: `tomevault-io/macos-tag-manager` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/macos-tag-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/macos-tag-manager/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/macos-tag-manager

---


# macOS Tag Manager

## Overview
Use this skill to apply or customize Finder tag automation with the repo scripts. Focus on guiding users through prerequisites, choosing the right script, and editing tag mappings safely.

## Quick decision guide
- **Semantic tagging by context** → use `tagger.sh`.
- **Frequency-based smart organization** → use `smart_organize.sh`.
- **Need custom mappings** → edit `TAG_MAP` in `tagger.sh` before running.

## Workflow
1. **Confirm prerequisites**
   - macOS.
   - Homebrew installed.
   - `tag` CLI available (install with `brew install tag` if missing).
2. **Pick the script**
   - `tagger.sh` for semantic/context tags.
   - `smart_organize.sh` for usage-frequency emoji tags.
3. **Customize (optional)**
   - Edit `TAG_MAP` in `tagger.sh` to add/remove paths and tags.
   - Keep tags comma-separated (e.g., `"Development,⭐"`).
4. **Run**
   - `chmod +x tagger.sh && ./tagger.sh`
   - or `chmod +x smart_organize.sh && ./smart_organize.sh`
5. **Verify**
   - Ask the user to check Finder tags or the Finder sidebar for tag groups.

## Guidance for changes
- When modifying `TAG_MAP`, preserve the associative array structure and quote paths.
- Avoid tagging system-critical directories unless the user confirms.
- If a user wants AI-generated mappings, point them to `AI_PROMPT.md` and offer to draft a mapping.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/683280yj) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->