# Brain Init

> Initialize brain sync network. Creates a Git remote for your brain and exports your current Claude Code state.

- **Type:** Skill
- **Install:** `agentstack add skill-toroleapinc-claude-brain-brain-init`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [toroleapinc](https://agentstack.voostack.com/s/toroleapinc)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [toroleapinc](https://github.com/toroleapinc)
- **Source:** https://github.com/toroleapinc/claude-brain/tree/main/skills/brain-init
- **Website:** https://toroleapinc.github.io/claude-brain/

## Install

```sh
agentstack add skill-toroleapinc-claude-brain-brain-init
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

The user wants to initialize their Claude Brain sync network.

Parse arguments:
- If arguments contain "--encrypt", enable encryption
- The first non-flag argument is the Git remote URL

Arguments provided: $ARGUMENTS

## Steps

1. First, check dependencies by running:
   ```
   "${CLAUDE_PLUGIN_ROOT}/scripts/common.sh" && echo "OK"
   ```
   If jq and git are missing, tell the user what to install.

2. Validate the remote URL for security:
   ```bash
   source "${CLAUDE_PLUGIN_ROOT}/scripts/common.sh"
   validate_remote_url "$ARGUMENTS"
   ```
   If the URL is detected as pointing to a PUBLIC repository, STOP and warn the user:
   - "WARNING: This repository appears to be PUBLIC. Your brain data (memory, skills, settings, and potentially sensitive information) will be visible to anyone."
   - "Please use a PRIVATE repository."
   - Ask the user if they want to continue anyway.

3. Show the user their current brain inventory by running:
   ```
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/status.sh"
   ```

4. **IMPORTANT: Show the user a security notice before proceeding:**
   Tell the user:
   - "Brain sync will export the following to the Git remote:"
   - "  - CLAUDE.md, rules, skills, agents (your instructions and workflows)"
   - "  - Auto memory and agent memory (learned patterns from your sessions)"
   - "  - Settings (hooks, permissions — NOT env vars)"
   - "  - MCP server configurations (command/args only — env vars with API keys are STRIPPED)"
   - "  - Keybindings"
   - ""
   - "What is NEVER exported: OAuth tokens, API keys in env vars, ~/.claude.json, session transcripts"
   - ""
   - "Note: Memory files may contain information from your conversations. Review ~/.claude/projects/*/memory/ if concerned."

5. Ask the user to confirm they want to initialize brain sync with the provided remote.

6. Run the initialization sequence:
   ```bash
   # Parse arguments for encryption flag
   ENABLE_ENCRYPTION=false
   REMOTE_URL=""
   for arg in $ARGUMENTS; do
     case "$arg" in
       --encrypt) ENABLE_ENCRYPTION=true ;;
       *) if [ -z "$REMOTE_URL" ]; then REMOTE_URL="$arg"; fi ;;
     esac
   done

   # Create brain repo directory
   mkdir -p ~/.claude/brain-repo

   # Initialize git repo
   cd ~/.claude/brain-repo
   git init
   git remote add origin "$REMOTE_URL" 2>/dev/null || git remote set-url origin "$REMOTE_URL"

   # Create directory structure
   mkdir -p machines consolidated meta

   # Initialize meta files
   echo '{"entries":[]}' > meta/merge-log.json

   # Set up encryption if requested
   if [ "$ENABLE_ENCRYPTION" = "true" ]; then
     echo "Setting up age encryption..."
     
     # Check if age is installed
     if ! command -v age-keygen &>/dev/null; then
       echo "ERROR: age not found. Install it from https://github.com/FiloSottile/age"
       echo "On macOS: brew install age"
       echo "On Ubuntu/Debian: apt install age"
       exit 1
     fi

     # Generate age keypair
     source "${CLAUDE_PLUGIN_ROOT}/scripts/common.sh"
     IDENTITY_FILE="${HOME}/.claude/brain-age-key.txt"
     RECIPIENTS_FILE="${HOME}/.claude/brain-repo/meta/recipients.txt"
     generate_age_keypair "$IDENTITY_FILE" "$RECIPIENTS_FILE"
     
     echo "Age encryption configured:"
     echo "  Private key: $IDENTITY_FILE"
     echo "  Public key: $RECIPIENTS_FILE"
   fi

   # Register this machine (with encryption settings)
   if [ "$ENABLE_ENCRYPTION" = "true" ]; then
     bash "${CLAUDE_PLUGIN_ROOT}/scripts/register-machine.sh" "$REMOTE_URL" --encrypt
   else
     bash "${CLAUDE_PLUGIN_ROOT}/scripts/register-machine.sh" "$REMOTE_URL"
   fi

   # Export initial brain snapshot
   MACHINE_ID=$(cat ~/.claude/brain-config.json | jq -r '.machine_id')
   mkdir -p "machines/${MACHINE_ID}"
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/export.sh" --output "machines/${MACHINE_ID}/brain-snapshot.json"

   # Copy as initial consolidated brain
   cp "machines/${MACHINE_ID}/brain-snapshot.json" consolidated/brain.json

   # Commit and push (specific paths, not -A)
   git add machines/ consolidated/ meta/
   git commit -m "Initialize brain: $(hostname)"
   git branch -M main
   git push -u origin main
   ```

7. Confirm success and show the user:
   - Their machine ID and name
   - The remote URL
   - Instructions: "Install claude-brain on your other machines and run: /brain-join $ARGUMENTS"
   - Reminder: "Auto-sync is enabled. Brain syncs silently on every session start/end."

If any step fails, show the error and suggest fixes (e.g., create the remote repo first on GitHub).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [toroleapinc](https://github.com/toroleapinc)
- **Source:** [toroleapinc/claude-brain](https://github.com/toroleapinc/claude-brain)
- **License:** MIT
- **Homepage:** https://toroleapinc.github.io/claude-brain/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-toroleapinc-claude-brain-brain-init
- Seller: https://agentstack.voostack.com/s/toroleapinc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.