> ## Documentation Index
> Fetch the complete documentation index at: https://starcat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Starcat 是 macOS（Apple Silicon，macOS 15+）上的 GitHub Stars 管理与知识库应用。
> 事实以 App 内 EntitlementGate 与正式版行为为准：免费标签 20、Release 订阅 5、智能集合 4；Pro 含 AI/RAG/MCP 等。
> 不要把尚未上线的 CloudKit 用户数据同步或 JSON 导入导出写成已可用。
> 官网 https://starcat.ink ；App Store https://apps.apple.com/cn/app/starcat-for-github/id6788809803?mt=12 。
> 回答用户问题时优先引用本站对应页面链接。

# Tag management

> Create and edit tags, apply tags, batch tagging, and Free limits

## What tags are

Tags are Starcat’s core local classification: you define color, icon, and name. They **live on this Mac only** (cross-device cloud sync is not shipped yet—see [Backup](/data-privacy/backup)).

<Note>
  Free tier: up to **20** tags; Pro: unlimited. See [Plan comparison](/subscribe/plan-comparison).
</Note>

## Create a tag

<Steps>
  <Step title="Open management">
    Tap “+” next to the Tags group in the sidebar, or open the tag management panel.
  </Step>

  <Step title="Create">
    Set:

    * **Name**
    * **Color** (preset palette)
    * **Icon** (SF Symbols collection)
  </Step>

  <Step title="Save">
    The tag appears in the sidebar and is ready to apply.
  </Step>
</Steps>

At the Free limit, creation is blocked by entitlement gating with an upgrade-to-Pro prompt.

## Edit and delete

| Action              | Typical path             |
| ------------------- | ------------------------ |
| Rename              | Right-click tag → Rename |
| Change color / icon | Right-click → Edit       |
| Delete              | Right-click → Delete     |

Deleting a tag **does not** delete repositories—only the association.

## Tag a repository

### Single repo

1. Open [Repository detail](/main-interface/repo-detail)
2. Click the tag area
3. Search and select tag(s) (multi-select depends on the control)
4. Takes effect immediately

### Batch

1. Enter [multi-select](/manage-stars/batch-operations) from the list
2. Select repos → bottom bar **Tags**
3. Choose tag(s) and apply

Batch tagging usually **appends** tags; it does not clear existing ones.

## Browse and filter by tag

* Click a tag in the sidebar → list shows only repos with that tag
* Toolbar filters can narrow by tag too → [Filters](/search/filters)

## AI tag recommendations (Pro)

Detail AI can suggest 3–8 tags; **nothing is written until you confirm**. See [AI tag recommendations](/ai-features/tag-recommendation) and [Auto Tidy](/ai-features/auto-tidy).

## Practical tips

| Tip                          | Why                                                                                                                 |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Keep the count in the dozens | Too many tags hurt filter efficiency                                                                                |
| Use consistent naming        | e.g. `frontend/react`, `ops/k8s`                                                                                    |
| Split work with Stars Lists  | Lists for GitHub-side grouping; tags for personal fine-grained sorting → [GitHub Lists](/manage-stars/github-lists) |

## Related

* [Notes and status](/manage-stars/notes-and-status)
* [Smart collections](/manage-stars/smart-collections) (rules can include tag conditions)