# agent-sync

**Repository Path**: qa594741/agent-sync

## Basic Information

- **Project Name**: agent-sync
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-09
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Sync

This repository is a Git-backed sync package for local agent skills and plugin setup.

It syncs:

- one common skill library in `skills/common`
- the same common skill library into agents, Codex, Claude Code, and OpenCode
- Claude Code subagent wrappers
- OpenCode local skills and instruction files
- a reproducible Codex plugin install list and small, intentional plugin files

It does not sync secrets, auth files, histories, logs, caches, `node_modules`, full plugin marketplace checkouts, or machine-specific runtime plugin files.

## Use On A New Computer

Clone the remote repository to a normal local development folder, then enter the repository:

```powershell
git clone https://gitee.com/qa594741/agent-sync.git
cd agent-sync
```

Open PowerShell in the `agent-sync` folder, then run:

```powershell
Set-ExecutionPolicy -Scope Process Bypass
& ".\install.ps1"
```

Default behavior is merge/update. It copies `skills/common` into every local skill directory without deleting target-only files. This keeps all four tools as consistent as possible while following the rule: add missing skills and update common files, do not remove extra local skills unless explicitly requested.

Use `-Mirror` only when you want the target directories to exactly match this package:

```powershell
& ".\install.ps1" -Mirror
```

## Refresh This Package From The Main Computer

After adding or changing skills on the main computer:

```powershell
& ".\export.ps1"
git status
git add <changed-files>
git commit -m "老大 第N次提交"
git push
```

On another computer, receive updates with:

```powershell
git pull
& ".\install.ps1"
```

After exporting or installing new skills/plugins on any computer, append a record to `SYNC_LOG.md`. Record the computer label, time, action, and what changed so the user and other computers can see what changed.

## Notes

Plugin marketplaces are not stored in this repository. Add marketplace sources on each computer with the local client command, then use this repository for the plugin list and for single plugins that must be carried directly.

Known Codex marketplace sources to add manually when needed:

```powershell
codex plugin marketplace add https://github.com/Yuan1z0825/nature-skills.git --ref main
codex plugin marketplace add https://github.com/hashgraph-online/awesome-codex-plugins.git --ref main
codex plugin marketplace add https://github.com/duyet/claude-plugins.git
```

Codex `openai-bundled` plugins such as Browser, Chrome, Computer Use, Sites, and LaTeX are not exported here. They are tied to the Codex runtime/app installation and should be installed or regenerated by Codex itself on each machine.

OpenCode provider settings are not exported because they contain API keys. Use `opencode/opencode.template.json` as a safe reference and keep real provider credentials local.

## Repository Rule

This repository is shared across machines. Any AI or user modifying it must read `AGENTS.md` first and follow its commit naming and sync rules.