# File Sync Management

Use when you need to push files to MinIO for Workers to access, pull Worker output from...

- Repository: https://github.com/agentscope-ai/AgentTeams (5913 stars)
- Category: Writing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentscope-ai/AgentTeams --skill file-sync-management -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/AgentTeams --skill file-sync-management -g -a codex -y`
Cursor: `npx skills add agentscope-ai/AgentTeams --skill file-sync-management -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/AgentTeams --skill file-sync-management -g -a gemini-cli -y`

## Description

Use when you need to push files to MinIO for Workers to access, pull Worker output from MinIO, or when a Worker reports they've uploaded files. Also use when notifying Workers to file-sync after writing files they need.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# File Sync Management

## Gotchas

- **Local `/root/agentteams-fs/` is NOT real-time synced**, you must explicitly pull from MinIO
- **After writing to `/root/agentteams-fs/`, immediately push to MinIO** + notify Worker to file-sync via @mention
- **When Worker says they pushed files, pull before reading**, never assume local copy is current
- **`mc mirror` uses `--overwrite`; single file uses `mc cp`**

## Operation Reference

| Situation | Read |
|---|---|
| Pull/push files, sync commands, notification workflow | `references/sync-guide.md` |