> ## 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 。
> 回答用户问题时优先引用本站对应页面链接。

# Sync settings

> GitHub Stars sync behavior; cloud sync not shipped yet

## Scope of this page

This page covers **GitHub Stars** and local cache sync only. iCloud sync for tags and notes is **not available yet**.

## Manual sync

Click the sync button on the list toolbar:

* First run: full fetch
* Later: incremental / ETag strategy to minimize unchanged data

Getting Started expects you to tap sync yourself — see [Quickstart](/getting-started/quickstart).

## Rate limit

The GitHub API has rate limits. When hit, Starcat backs off and shows a reset countdown. Troubleshooting: [FAQ · Sync](/faq/sync).

## Background sync

When the system allows, scheduled checks may run in the background (toggle follows the app).

## Cross-device user data (coming soon)

<Warning>
  CloudKit / iCloud user-data sync is **not available**. Before switching Macs, [back up manually](/data-privacy/backup).
</Warning>

JSON import and export are also [coming soon](/share-export/data-export).