File syncSafety

Sync limits and exclusions

Compare terminal and Command Centre client sync limits.

The terminal and Command Centre use different client sync flows.

Terminal push

npm run team -- sync push includes text files up to 1 MB. It skips:

  • .env, .env.local, .env.*, and .mcp.json
  • .git, .next, .memsearch, .command-centre, and node_modules
  • backups, coverage, and dist
  • clients/<slug>/context/transcripts
  • non-text files and files larger than 1 MB

These rules apply to files collected from the local source for a terminal push. The server still enforces Team and client access.

Command Centre client sync

Command Centre can sync regular text or binary files under the selected client workspace, up to 25 MB per file. It does not use the terminal push exclusion list.

Files named .env, .env.local, .env.*, or .mcp.json are marked as secrets. They are hidden from users with only read access. Users with write access can sync them, so review the file list before confirming.

Use Team > Secrets when a value should be managed as a Team secret instead of a client file.

Next: Sync revoke behavior

On this page