brain-join
starsforks
How to install brain-join?
toroleapinc/claude-brain/brain-join
$npx -y skills add toroleapinc/claude-brain --skill brain-joinJoin an existing brain sync network from another machine. Pulls the consolidated brain and merges with any local state.
SKILL.md
| 1 | The user wants to join an existing brain network from this machine. |
| 2 | |
| 3 | The Git remote URL is provided as: $ARGUMENTS |
| 4 | |
| 5 | ## Steps |
| 6 | |
| 7 | 1. Check dependencies (git, jq or python3). |
| 8 | |
| 9 | 2. Validate the remote URL for security: |
| 10 | ```bash |
| 11 | source "${CLAUDE_PLUGIN_ROOT}/scripts/common.sh" |
| 12 | validate_remote_url "$ARGUMENTS" |
| 13 | ``` |
| 14 | If the URL appears to point to a PUBLIC repo, warn the user and ask for confirmation. |
| 15 | |
| 16 | 3. Show current local brain inventory: |
| 17 | ``` |
| 18 | bash "${CLAUDE_PLUGIN_ROOT}/scripts/status.sh" |
| 19 | ``` |
| 20 | |
| 21 | 4. **Show security notice:** |
| 22 | - "Joining a brain network means:" |
| 23 | - " - Your local brain data will be PUSHED to the remote repository" |
| 24 | - " - Remote brain data (skills, agents, rules) will be IMPORTED to your machine" |
| 25 | - " - Auto-sync will run on every Claude Code session start/end" |
| 26 | - "" |
| 27 | - "Only join brain networks you trust — imported skills and agents execute with Claude's permissions." |
| 28 | |
| 29 | 5. Clone the brain repo: |
| 30 | ```bash |
| 31 | git clone "$ARGUMENTS" ~/.claude/brain-repo |
| 32 | ``` |
| 33 | If the directory exists, do `git -C ~/.claude/brain-repo pull origin main` instead. |
| 34 | |
| 35 | 6. Check if the network uses encryption: |
| 36 | ```bash |
| 37 | # Check for recipients file indicating encryption |
| 38 | if [ -f ~/.claude/brain-repo/meta/recipients.txt ]; then |
| 39 | echo "This brain network uses age encryption." |
| 40 | |
| 41 | if ! command -v age-keygen &>/dev/null; then |
| 42 | echo "ERROR: age not found. Install it from https://github.com/FiloSottile/age" |
| 43 | echo "On macOS: brew install age" |
| 44 | echo "On Ubuntu/Debian: apt install age" |
| 45 | exit 1 |
| 46 | fi |
| 47 | |
| 48 | echo "" |
| 49 | echo "You need to set up age encryption to join this network." |
| 50 | echo "Options:" |
| 51 | echo " 1. Generate a new age keypair for this machine" |
| 52 | echo " 2. Use an existing age private key" |
| 53 | echo "" |
| 54 | read -p "Generate new keypair? (y/n): " -r generate_key |
| 55 | |
| 56 | if [ "$generate_key" = "y" ] || [ "$generate_key" = "Y" ]; then |
| 57 | # Generate new keypair |
| 58 | source "${CLAUDE_PLUGIN_ROOT}/scripts/common.sh" |
| 59 | IDENTITY_FILE="${HOME}/.claude/brain-age-key.txt" |
| 60 | age-keygen -o "$IDENTITY_FILE" |
| 61 | chmod 600 "$IDENTITY_FILE" |
| 62 | |
| 63 | # Extract public key |
| 64 | PUBLIC_KEY=$(grep "# public key:" "$IDENTITY_FILE" | cut -d' ' -f4) |
| 65 | echo "" |
| 66 | echo "Generated age keypair. Your public key is:" |
| 67 | echo "$PUBLIC_KEY" |
| 68 | echo "" |
| 69 | echo "IMPORTANT: Share this public key with the brain network owner" |
| 70 | echo "so they can add it to the recipients file." |
| 71 | echo "" |
| 72 | echo "The network owner should run:" |
| 73 | echo " echo '$PUBLIC_KEY' >> ~/.claude/brain-repo/meta/recipients.txt" |
| 74 | echo " git add meta/recipients.txt && git commit -m 'Add machine: $(hostname)' && git push" |
| 75 | echo "" |
| 76 | read -p "Press Enter when the network owner has added your public key..." |
| 77 | |
| 78 | # Pull to get updated recipients |
| 79 | git -C ~/.claude/brain-repo pull origin main |
| 80 | |
| 81 | REGISTER_FLAGS="--encrypt" |
| 82 | else |
| 83 | echo "Please place your existing age private key at: ~/.claude/brain-age-key.txt" |
| 84 | echo "Make sure it's readable only by you: chmod 600 ~/.claude/brain-age-key.txt" |
| 85 | read -p "Press Enter when ready..." |
| 86 | |
| 87 | if [ ! -f ~/.claude/brain-age-key.txt ]; then |
| 88 | echo "ERROR: Age private key not found at ~/.claude/brain-age-key.txt" |
| 89 | exit 1 |
| 90 | fi |
| 91 | |
| 92 | REGISTER_FLAGS="--encrypt" |
| 93 | fi |
| 94 | else |
| 95 | echo "This brain network does not use encryption." |
| 96 | REGISTER_FLAGS="" |
| 97 | fi |
| 98 | ``` |
| 99 | |
| 100 | 7. Register this machine: |
| 101 | ```bash |
| 102 | if [ -n "$REGISTER_FLAGS" ]; then |
| 103 | bash "${CLAUDE_PLUGIN_ROOT}/scripts/register-machine.sh" "$ARGUMENTS" $REGISTER_FLAGS |
| 104 | else |
| 105 | bash "${CLAUDE_PLUGIN_ROOT}/scripts/register-machine.sh" "$ARGUMENTS" |
| 106 | fi |
| 107 | ``` |
| 108 | |
| 109 | 8. Show what's in the consolidated brain vs what's local. Run export first: |
| 110 | ```bash |
| 111 | MACHINE_ID=$(cat ~/.claude/brain-config.json | jq -r '.machine_id') |
| 112 | mkdir -p ~/.claude/brain-repo/machines/${MACHINE_ID} |
| 113 | bash "${CLAUDE_PLUGIN_ROOT}/scripts/export.sh" --output ~/.claude/brain-repo/machines/${MACHINE_ID}/brain-snapshot.json |
| 114 | ``` |
| 115 | |
| 116 | 9. Ask the user how to handle existing local data: |
| 117 | - **Merge** (recommended): Merge local brain into consolidated |
| 118 | - **Overwrite**: Replace local with consolidated brain |
| 119 | - **Keep local**: Keep local as-is, only add new items from consolidated |
| 120 | |
| 121 | 10. Based on choice: |
| 122 | - **Merge**: Run merge-structured.sh then merge-semantic.sh between local snapshot and consolidated |
| 123 | - **Overwrite**: Run import.sh directly with consolidated brain |
| 124 | - **Keep local**: Run import.sh but skip files that already exist locally |
| 125 | |
| 126 | 11. Push the updated state: |
| 127 | ```bash |
| 128 | cd ~/.claude/brain-repo |
| 129 | git add machines/ consolidated/ meta/ |
| 130 | git commit -m "Join: $(hostname) joined brain network" |
| 131 | g |
People who liked this also viewed
6 picksType
- lark-drive飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sSkillsJul 2026
- lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handlingSkillsJul 2026
- lark-whiteboard飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。SkillsJul 2026
- lark-task飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。SkillsJul 2026
- lark-attendance飞书考勤打卡：查询自己的考勤打卡记录SkillsJul 2026
- lark-apps妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要SkillsJul 2026
