harleycoops GBrain for WorkspaceAlberta
Use this skill when an agent working in this repository needs to search, query, sync, or understand the WorkspaceAlberta knowledge context through GBrain.
GBrain is Garry Tan's open-source personal knowledge brain: a local-first TypeScript CLI and MCP server that stores a searchable brain in ~/.gbrain, supports hybrid keyword/vector retrieval, and can sync git repositories as recurring sources.
Local setup
- GBrain wrapper:
/home/chris/.local/bin/gbrain - Local GBrain checkout:
/home/chris/gbrain - Brain repository:
/home/chris/brain - Brain database:
/home/chris/.gbrain/brain.pglite - WorkspaceAlberta source id:
workspacealberta - WorkspaceAlberta path:
/mnt/c/Users/chris/WorkspaceAlberta - Source marker:
.gbrain-source
Use the explicit wrapper path. Do not rely on PATH, because other shells may resolve a different gbrain binary.
Common commands
From anywhere:
GB=/home/chris/.local/bin/gbrain
REPO=/mnt/c/Users/chris/WorkspaceAlberta
"$GB" sources list
"$GB" sync --source workspacealberta --no-pull --yes --no-embed
"$GB" search "WorkspaceAlberta"
"$GB" query "what does this repo say about CanadaBuys and MCP?" --no-expand
# Optional, when embedding quota is available:
"$GB" embed --stale
From the repo root:
GB=/home/chris/.local/bin/gbrain
"$GB" sync --source workspacealberta --no-pull --yes --no-embed
"$GB" search "Wouldn't it be great if"
# Optional, when embedding quota is available:
"$GB" embed --stale
How to use it here
- Treat GBrain as a lookup and indexing layer for repository context.
- Use it to retrieve prior research, specs, and cross-file context before broad edits.
- Keep CanadaBuys as the primary working integration for procurement tasks.
- Do not use GBrain as a replacement for the repository's canonical tests, source files, or MCP server behavior.
- After changing repo docs or agent setup, sync the source and verify with a known phrase search.
Verification checklist
After installation or meaningful repo documentation changes:
GB=/home/chris/.local/bin/gbrain
cd /mnt/c/Users/chris/WorkspaceAlberta
"$GB" sources list
"$GB" sync --source workspacealberta --no-pull --yes --no-embed
"$GB" search "CanadaBuys MCP server"
# Optional, when embedding quota is available:
"$GB" embed --stale
python -m unittest tests.test_canadabuys_mcp_smoke
Expected signs of success:
sources listincludesworkspacealbertawith nonzero pages.- Search returns visible WorkspaceAlberta files such as
README.mdorAGENTS.md. - The CanadaBuys MCP smoke test passes.
Guardrails
- Do not publish private local brain contents.
- Do not commit generated brain databases or local GBrain state.
- Hidden skill directories may not be indexed by GBrain source sync. Verify this file directly, then verify GBrain ingest using visible files like
AGENTS.mdandREADME.md. - If OpenAI embedding quota is exhausted, use
sync --no-embedand keywordsearchfor verification. Runembed --stalelater when quota is available to enable vector/hybrid quality. - Confirm before changing external services, remote MCP deployments, or hosted GBrain HTTP/OAuth configuration.