---
name: github-sync
description: Connect this brain to a private GitHub repository and keep it synced — install/sign in to the GitHub CLI, create the repo, set it as `origin`, push the full history, record it in `Agent/config.json`, and run the ongoing push/pull routine. Use when the owner says "sync to github", "back this up to github", "put my brain on github", "add a github remote", "push my brain to github", or asks how to back up or sync their notes off this machine. NOT an email setup of any kind (a local brain has no email channel) and NOT first-time setup (alexandria-install).
---

# github-sync — folder-root adapter

The real playbook lives in the brain: **`Agent/skills/github-sync.md`** (this folder
is the vault root). Read that file and follow it exactly as written, using the
shipped CLI at `.alexandria/app/.venv/bin/alexandria` wherever it says
`alexandria`, and `.alexandria/app/.venv/bin/python` for
`python -m alexandria_vault.…` entrypoints.

If `Agent/config.json` does not exist, nothing is installed yet — stop and
follow `./CLAUDE.md` (the installer) instead of this skill.
