Skip to content

arminzou/dotbrain / plugin/skills/wire-brain

wire-brain

Verified

Wires, 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.

FileKindSize
SKILL.mdskill md8.2 KB
agents/openai.yamlconfig103 B
references/worktree.mdmarkdown2.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.
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall