setup-gbrain

Install the gbrain CLI and initialize a local PG Lite or Supabase brain on macOS.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

gbrain provides a persistent memory store for the coding agent by running locally on macOS, enabling memory recall, cross-machine synchronization, and policy-driven behavior.

Core Features & Use Cases

  • Install the gbrain CLI on macOS and initialize a local brain (PG Lite or Supabase) to serve as the agent's memory.
  • Register Claude's MCP for the local brain so the agent can call it as a persistent memory backend and enforce per-remote trust policies.
  • Support per-repo policy migrations, vendoring considerations, and team-mode onboarding to coordinate across developers.

Quick Start

Run /setup-gbrain to install the CLI, initialize a local brain, and register MCP so your agent is ready to use.

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 a persistent memory store for a coding agent on macOS?

To set up a persistent memory store for a coding agent on macOS, you need to install the gbrain CLI, initialize a local brain using PG Lite or Supabase, and register the MCP backend. This enables memory recall and cross-machine synchronization.

What is the best way to provide cross-machine memory synchronization for my coding agent?

Providing cross-machine memory synchronization involves running gbrain locally and registering Claude's MCP for the local brain. This allows the agent to call it as a persistent memory backend and enforce per-remote trust policies.

Can I use Supabase instead of PG Lite for my local coding agent brain?

Yes, you can use Supabase instead of PG Lite for your local coding agent brain. During initialization, gbrain supports both PG Lite and Supabase to serve as the agent's local memory backend on macOS.

How do I configure per-remote trust policies for an MCP memory backend?

Configuring per-remote trust policies for an MCP memory backend is handled when you register Claude's MCP for the local gbrain brain. This registration enforces policy-driven behavior and coordinates access across different remotes.

Does setting up gbrain require any specific permissions for team-mode onboarding?

Setting up gbrain for team-mode onboarding requires a macOS environment with a local brain backend and permissions to configure per-remote trust policies. This supports per-repo policy migrations and vendoring considerations across developers.

Why does my coding agent need a local brain backend like PG Lite?

A coding agent needs a local brain backend like PG Lite to provide a persistent memory store. This enables the agent to recall previous context, synchronize memory across machines, and execute policy-driven behavior during development.