setup-gbrain

Installs and configures the gbrain CLI with local PGLite or Supabase storage and MCP registration.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aicodepro/ai-agent-nexi --skill setup-gbrain-aicodepro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-gbrain
Source: https://github.com/aicodepro/ai-agent-nexi/tree/main/agent/skills/gstack/setup-gbrain
Command: npx skills add https://github.com/aicodepro/ai-agent-nexi --skill setup-gbrain-aicodepro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a persistent memory and search backend for a coding agent involves many manual steps: installing the gbrain CLI, choosing a storage engine, registering an MCP server, and defining per-repo trust policies. This Skill compresses that into one guided, idempotent workflow. ## Core Features & Use Cases - End-to-end gbrain setup: Installs the CLI, initializes a local PGLite or Supabase brain, and registers the MCP server (local stdio or remote HTTP with bearer token verification). - Transcript and memory ingest: Optionally ingests Claude Code, Codex, and Cursor session transcripts plus learnings, timelines, and design docs into gbrain, with optional gitleaks secret scanning. - Trust policy and artifacts sync: Captures per-remote trust policy (read/write/deny) and configures cross-machine artifact sync to a private GitHub or GitLab repo. - Use Case: A developer on a new machine runs the setup once and gets a working semantic search brain over their code and past sessions, with remote-MCP mode for connecting to a teammate's hosted gbrain server. ## Quick Start Ask the agent to set up gbrain on this machine and connect it to this project.

Frequently Asked Questions about setup-gbrain

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up gbrain for my coding agent?

Run the setup-gbrain skill, which walks through installing the gbrain CLI, initializing a local PGLite or Supabase brain, registering the MCP server, and capturing per-remote trust policy in one guided flow.

How do I connect to a remote gbrain server over MCP?

Use Path 4 of the setup flow: provide the MCP URL and a bearer token issued by the brain admin. The skill verifies connectivity, classifies network, auth, or malformed-header failures, and registers the MCP at user scope.

Does gbrain ingest scan transcripts for secrets?

Per-file gitleaks scanning during memory ingest is opt-in and off by default. Enable it with the --scan-secrets flag or the GSTACK_MEMORY_INGEST_SCAN_SECRETS environment variable; sessions with findings are skipped entirely.

Can I use gbrain without installing anything locally?

Yes, remote-MCP mode connects to a gbrain server hosted by a teammate or another machine over HTTP, Tailscale, or LAN. It skips local install, doctor checks, and transcript ingest, which all require a local CLI.

What data stays local and never syncs to the brain remote?

State files, sessions with no resolvable git remote, and repos under a deny trust policy never sync. Code and transcripts never go into the brain-linked git repo; only curated memory artifacts are pushed.