# Github Sync

> Bidirectional sync between GitHub and Vertex AI. Use "/github-sync" to sync Use when this capability is needed.

- Skill: `tomevault-io/github-sync` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/github-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/github-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/github-sync

---


# GitHub ↔ Vertex AI Sync Skill

## Purpose
Synchronize knowledge between GitHub docs/brain/ and Vertex AI RAG (BigQuery + GCS)

## Sync Directions

### 1. GitHub → Vertex AI
When files in `docs/brain/` change:
- Generate embeddings using Vertex AI Embeddings API
- Store in BigQuery for similarity search
- Backup to GCS

### 2. Vertex AI → GitHub
When AI debates conclude:
- Update `docs/brain/DECISIONS.md` with results
- Commit changes automatically
- Create PR if configured

## Usage

```bash
# Bidirectional sync (default)
/github-sync

# GitHub to Vertex only
/github-sync --to-vertex

# Vertex to GitHub only
/github-sync --from-vertex

# Initial full sync
/github-sync --initial-sync
```

## What Gets Synced

### To Vertex AI:
- `docs/brain/CONTEXT.md`
- `docs/brain/DECISIONS.md`
- `docs/brain/DEBATES.md`
- All `.md` files in `docs/brain/`

### From Vertex AI:
- Debate results → `docs/brain/DECISIONS.md`
- Session logs → `docs/brain/DEBATES.md`
- Knowledge updates → `docs/brain/CONTEXT.md`

## Conflict Resolution
- Vertex AI is source of truth for decisions
- GitHub is source of truth for manual edits
- Timestamp-based merge for conflicts

## Implementation
Python script: `.claude/skills/github-sync/sync_manager.py`
- Git diff detection for changed files
- Vertex AI Embeddings API for vectorization
- BigQuery upload with deduplication
- GCS backup with versioning

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/topoface) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->