arminzou/dotbrain / plugin/skills/wire-brain
wire-brain
VerifiedWires, repairs, refreshes, or inspects a repo's dotbrain Brainspace by driving the dotbrain CLI. Use when starting a project under dotbrain, attaching an existing repo to a Brainspace, repairing wiring in a main checkout or linked Git worktree, reconciling agent workspace resources after an upgrade, or checking bootstrap expectations.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| agents/openai.yaml | config | 103 B |
| references/worktree.md | markdown | 2.3 KB |
references/worktree.md
View on GitHub# Worktree attachment
Use the CLI to connect a linked Git worktree to its main checkout's existing Brainspace.
Git metadata supplies the main checkout; directory placement and worktree names do not supply
project identity. A missing or conflicting main-checkout relationship is an error to resolve
before attaching.
## Attach
From the worktree, run:
```bash
dotbrain wire
dotbrain doctor
```
From elsewhere, run `dotbrain wire --repo <worktree>`. The CLI creates direct `.brain` and enabled
`.beads` links into the shared Brainspace and real checkout-local runtime directories. It delivers
the selected skills and subagents, preserving project-owned workspace files. It keeps the
registered main-checkout path and project declarations unchanged.
On Windows, enable Developer Mode if directory symlink creation fails, then repeat the CLI
operation. Use the CLI's diagnostics rather than hand-creating links.
## Maintain or detach
```bash
dotbrain refresh
dotbrain skills link
dotbrain subagents link
dotbrain unwire
```
Run these from the wired worktree. Refresh and asset linking target that checkout; refresh also
maintains the shared Brain conventions and tracker. Asset linking can explicitly target another
wired checkout with `--repo <worktree>`; any `--project` must match its wiring.
Detachment removes only this checkout's managed wiring and pointer. It preserves the shared
Brain and tracker, main-checkout registration, user-owned workspace content, and exclusion
entries still needed by another wired checkout. `--all` selects registered projects rather than
sweeping every worktree.
## Verify
- `dotbrain doctor` reports no relevant errors from the attached worktree.
- `.brain` resolves directly to the same Brainspace as the main checkout; enabled `.beads`
resolves directly to its shared execution store.
- Runtime directories match the declared `agents:` selection. Skills and custom Claude agents are
symlinks; Codex agents and packaged `dotbrain-<role>` agents are marked real files.
- `git rev-parse --git-path info/exclude` identifies the exclusion file holding managed entries.
- `git status --short` shows no unexpected tracked changes.
- Enabled Beads works with `bd ready`, including a valid empty tracker.
- Detachment leaves the main checkout and other wired worktrees usable.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |