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).

Free tier: up to 20 tags; Pro: unlimited. See Plan comparison.

Create a tag

1. Open management

   Tap “+” next to the Tags group in the sidebar, or open the tag management panel.

2. Create

   Set:

   • Name
   • Color (preset palette)
   • Icon (SF Symbols collection)
3. Save

   The tag appears in the sidebar and is ready to apply.

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
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 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

AI tag recommendations (Pro)

Detail AI can suggest 3–8 tags; nothing is written until you confirm. See AI tag recommendations and 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

Related

• Notes and status
• Smart collections (rules can include tag conditions)