agent-sync-sh 1.0.0__py3-none-any.whl

agent_sync_sh-1.0.0.dist-info/METADATA

@@ -0,0 +1,144 @@
+Metadata-Version: 2.1
+Name: agent-sync-sh
+Version: 1.0.0
+Summary: Canonical configs, fanned out to all your AI coding agents from the Commons, the canonical ~/.agents directory
+License: MIT
+Requires-Python: >=3.8
+Project-URL: Homepage, https://agent-sync.sh
+Project-URL: Repository, https://github.com/agent-sync-sh/agent-sync
+Description-Content-Type: text/markdown
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+
+# agent-sync
+
+**One canonical .agents/ folder, fanned out to all your AI coding agents.**
+
+Website and docs: <https://agent-sync.sh/>
+
+The Commons — the canonical `~/.agents/` directory — holds the single real copy of every
+config you share: skills, instructions, MCP servers, slash commands, agents and hooks.
+`agent-sync sync` fans it out to every agent you actually have installed.
+
+Configs that can be byte-identical everywhere are **symlinked**, so there is one file seen
+from ten places and drift is impossible by construction. Configs that cannot be — MCP
+servers and hooks, which live inside files the agent also owns, in formats no two agents
+share — are **rendered and key-merged**, with your other keys preserved.
+
+There is no state file. There never will be. The filesystem is the state.
+
+```
+~/.agents/
+├── skills/<name>/       fanned out as symlinks
+├── commands/<name>.md
+├── agents/<name>.md
+├── AGENTS.md            symlink, import-line, or rules-dir link per agent
+├── mcp.json             rendered into each agent's native dialect
+└── hooks/<Event>.toml   merged by command string
+```
+
+## Install
+
+```sh
+npm install -g agent-sync-sh   # prebuilt binary, macOS, Linux and Windows, no toolchain
+pip install agent-sync-sh      # the same binary, shipped as a wheel
+cargo install agent-sync-sh    # from source, needs Rust 1.97+
+
+npx agent-sync-sh doctor       # or try it first, without installing anything
+uvx agent-sync-sh doctor       # the same, if you reach for uv rather than npm
+```
+
+On macOS and Linux there is also a Homebrew tap. It lives in this repository rather
+than a separate `homebrew-agent-sync` one, so it is tapped by URL:
+
+```sh
+brew tap agent-sync-sh/tap https://github.com/agent-sync-sh/agent-sync
+brew trust agent-sync-sh/tap   # Homebrew 6 refuses to load untrusted third-party taps
+brew install agent-sync
+```
+
+## Use
+
+```sh
+agent-sync init            # create the Commons and report what this machine already has
+agent-sync adopt <path>    # take a path under management; --dry-run names the mechanic
+agent-sync sync            # fan out; --dry-run prints the full plan
+agent-sync status          # what is linked, what is not, and what is not ours
+agent-sync doctor          # installed agents, Commons hygiene, Sourced entries
+agent-sync revert <agent>  # offboard one agent (refuses until you disable it)
+agent-sync mcp list | adopt | remove | enable | disable
+```
+
+`adopt` picks its mechanic from where the path lives: a real config inside an agent's
+directory is **moved** into the Commons with a link left behind; a path inside a git repo
+becomes a **Sourced** entry — the Commons links out to it and the repo keeps the truth;
+anything else is **copied** in. To gate CI on drift use `status` (exit 0 clean, 2
+actionable, 1 error) — `sync --dry-run` previews, it does not gate.
+
+## Agents
+
+Claude Code, Codex, opencode, pi, oh-my-pi, OpenClaw, Hermes, Gemini CLI, Cursor, Windsurf,
+Roo and Cline. Detection is simply whether the agent's config directory exists — agent-sync
+never creates one. Agents that read `~/.agents/skills` natively (Codex, opencode, oh-my-pi,
+Gemini CLI, Cursor) get no skill links written, because nothing needs to be — and where an
+agent still reads its old fan-out directory beside the Commons (Codex, Cursor), `sync`
+prunes agent-sync's now-duplicate links from it.
+
+## Interop
+
+The Commons speaks the conventions that won: `skills/<name>/SKILL.md` — the layout
+opencode and friends read natively — one `AGENTS.md`, and an `mcp.json` in the standard
+`mcpServers` shape. `.agents` Protocol surfaces (`tasks/`, `memories/`, `models.json`,
+`system-prompt.md`) are recognized by `doctor` and never touched.
+
+## What it will not touch
+
+Anything it does not own. A symlink pointing outside the Commons, a hand-written file, an
+MCP server whose name isn't in the Commons — all Foreign, all reported by `status`, none
+ever modified. A real directory shadowing a Commons entry is a **Variant**: deliberate,
+preserved, and counted as actionable only when its contents are identical to the Commons
+copy, so you can dedupe on purpose.
+
+The Commons is exactly that — a commons, not agent-sync's alone. opencode, oh-my-pi and
+Hermes read `~/.agents/` themselves, and other tools keep their own files there. `doctor`
+names entries that aren't agent-sync's and leaves them be; `status` stays target-only,
+since a neighbour's file has no fan-out to report.
+
+## Configuration
+
+Optional `agent-sync.toml` in `$XDG_CONFIG_HOME/agent-sync/` (default `~/.config/agent-sync/`):
+disable targets, define custom ones, scope MCP servers per agent, per-agent Tweaks. The
+lock — agent-sync's only machine state — lives in `$XDG_STATE_HOME/agent-sync/` (default
+`~/.local/state/agent-sync/`). Environment: `AGENT_SYNC_HOME` relocates the Commons (doctor
+warns — native readers won't follow), `AGENT_SYNC_TARGET_ROOT` resolves everything against
+another root, `AGENT_SYNC_LOCK_TIMEOUT_MS` bounds the lock wait.
+
+## What it does not do
+
+No cross-machine sync — version the Commons with git or chezmoi. No undo — refusals come
+before writes, `sync` plans everything before writing anything, `sync` and `adopt` preview
+with `--dry-run`, re-runs are idempotent, and a git-versioned Commons is better history
+than any journal. **No memory sync**: agent memory is not a defined artifact and agent-sync will
+not pretend otherwise. No GUI, daemon or file watcher. It does not install skills; it fans
+out whatever is in the Commons, whoever put it there.
+
+On Windows, creating symlinks requires Developer Mode (Settings → System → For
+developers) or an elevated shell; `sync` says exactly that when it cannot link.
+
+## Name and inspiration
+
+The name is a nod to [GNU Stow](https://www.gnu.org/software/stow/), the classic symlink-farm
+manager — agent-sync does for agent configs what Stow does for dotfiles. The project is also
+inspired by two neighbours in the same space:
+[dotagents](https://github.com/iannuttall/dotagents) and
+[agentsync](https://github.com/spxrogers/agentsync).
+
+[Documentation](https://agent-sync.sh/docs) · [agent-sync.sh](https://agent-sync.sh) · MIT

agent_sync_sh-1.0.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+agent_sync_unsupported.py,sha256=dzYHQBizTv_AcZMabCA8eD2Iwkuk7TPvrWJNRUpvML0,824
+agent_sync_sh-1.0.0.dist-info/METADATA,sha256=fYZCCEeRua0rPVKHxHOQgdXPhsWnwBH5WjGsHW4WnIo,7009
+agent_sync_sh-1.0.0.dist-info/WHEEL,sha256=6uNMMHETqbni0mf_lve6cdt1R0kd90bPilAVwAQsESI,97
+agent_sync_sh-1.0.0.dist-info/entry_points.txt,sha256=dvOuQXgYWNsWhiijZ04-XFNnjULB0kHp7TEpPatfQls,59
+agent_sync_sh-1.0.0.dist-info/RECORD,,

agent_sync_sh-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: agent-sync build-wheels.py
+Root-Is-Purelib: true
+Tag: py3-none-any

agent_sync_sh-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agent-sync = agent_sync_unsupported:main

agent_sync_unsupported.py

@@ -0,0 +1,29 @@
+"""Stand-in for platforms with no prebuilt agent-sync binary.
+
+Ships only in the py3-none-any wheel. pip prefers a platform wheel whenever
+one matches, so this is reached only where none does.
+"""
+
+import platform
+import sys
+
+SUPPORTED = (
+    "macOS arm64 and x86_64, Linux aarch64 and x86_64 (manylinux 2.17+), "
+    "and Windows x64 and arm64"
+)
+
+
+def main():
+    sys.stderr.write(
+        f"agent-sync: no prebuilt binary for {sys.platform}-{platform.machine()}.\n"
+        "This is the fallback wheel — pip installs it only when no platform "
+        "wheel matches your machine.\n"
+        f"Prebuilt wheels exist for {SUPPORTED}.\n"
+        "To build from source instead: cargo install agent-sync-sh\n"
+        "Details: https://agent-sync.sh\n"
+    )
+    return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())