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

# Backup and restore

> Manual local backup; cloud sync not shipped yet

## Why back up

Tags, notes, status, smart collection rules, and similar data **cannot be regenerated from GitHub**. Back up before switching Macs, reinstalling, or using factory reset.

## Manual backup (recommended)

<Steps>
  <Step title="Quit Starcat completely">Avoid copying a database mid-write.</Step>

  <Step title="Copy the data directory">
    Common Direct path:

    ```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
    ~/Library/Application Support/Starcat/
    ```

    The App Store build lives in a sandbox container with a different path. Use the Finder shortcut under **Settings → Storage** to locate it, then copy.
  </Step>

  <Step title="Store somewhere safe">External drive or encrypted backup both work.</Step>
</Steps>

## Manual restore

1. Quit Starcat completely
2. Restore the backup to the **same channel's** path (do not mix App Store and Direct)
3. Open the app again

## Cloud sync (coming soon)

<Warning>
  iCloud / CloudKit user-data sync is **not available**. This site will not describe fake “turn on sync and you're done” steps.
</Warning>

## Priority table

| Priority | Data                                          |
| -------- | --------------------------------------------- |
| High     | Tags, notes, status, collection rules         |
| Medium   | AI / RAG session history                      |
| Low      | README / images / summary cache (rebuildable) |

Stars lists can be re-synced from GitHub — usually no separate backup needed.

## Related

* [Data storage](/data-privacy/storage)
* [Data export (coming soon)](/share-export/data-export)