Skip to content
RunWield Docs

Troubleshooting

Mnemoteca, Cymbal, or agent-browser is missing

Section titled “Mnemoteca, Cymbal, or agent-browser is missing”

Interactive agent workflows require all three binaries in PATH.

For a standalone shell install, rerun the RunWield installer to restore missing required helpers into the same install directory as wld:

Terminal window
curl -fsSL https://raw.githubusercontent.com/gandazgul/runwield/main/install.sh | bash

If you use a custom directory, pass the same WLD_INSTALL_DIR again. Existing helper binaries found on PATH or in the install directory are preserved; remove a RunWield-managed helper from WLD_INSTALL_DIR before rerunning if you want the installer to fetch a fresh copy.

For a Homebrew-owned install, repair packages instead:

Terminal window
brew reinstall gandazgul/tap/wld
brew reinstall gandazgul/tap/mnemoteca
brew reinstall 1broseidon/tap/cymbal ketch agent-browser

The Homebrew command is available only after the owner publishes gandazgul/homebrew-tap.

For a WinGet-owned Windows install, repair or reinstall the package instead of running the Unix installer:

Terminal window
winget repair --id Gandazgul.RunWield --exact
# If repair is not available in your WinGet version:
winget uninstall --id Gandazgul.RunWield --exact
winget install --id Gandazgul.RunWield --exact

The WinGet command is available only after Microsoft accepts the public listing. The Windows package keeps helper files private to the package and does not modify global PATH for them.

If you already have mnemoteca and need data from a pre-rename install, run the official Mnemoteca installer before installing RunWield v0.10.0. The RunWield installer preserves an existing mnemoteca executable and does not start the upstream migration flow.

Plan review UI does not open

Section titled “Plan review UI does not open”

Plan review runs inside the Workspace UI. For source checkouts, confirm the reviewed Plannotator source checkout and published Plannotator packages are available:

  • third_party/plannotator/ exists and matches third_party/plannotator-revision.txt.
  • deno task workspace:dev opens the development catalog for local/TUI and Workspace variants of the Plan Board, Plan Review, and Code Review. Use its direct links to open the fixture-backed review routes.
  • deno task workspace:check can resolve the @plannotator/* imports from deno.json and Workspace aliases.

A saved plan is not loading

Section titled “A saved plan is not loading”
  • Use wld plans to list plan names.
  • Use wld load-plan <name> for a plan in docs/plans/.
  • Use wld load-plan docs/plans/<name>.md for a direct path.
  • Use /resume only for chat sessions, not plan files.
  • If docs/plans/<name>.md was deleted or became unreadable during an active worktree run, use the Plan name rather than the path: wld load-plan <name>. RunWield will restore the file only when one matching execution worktree proves its identity; malformed bytes are backed up under .wld/recovery/.

Publication stopped or cleanup was incomplete

Section titled “Publication stopped or cleanup was incomplete”
  • A temporary remote failure is retried automatically. If retries run out, restore network access and run wld load-plan <name> again; the validated commits remain on the source branch.
  • If Git reports a force-with-lease race, RunWield rereads the target branch and retries with its new commits.
  • If publication succeeded but cleanup did not, follow the worktree path and source branch printed in the TUI. Inspect them with git status and git branch -vv, save any files you need, then run wld plans doctor before deleting anything manually.

Agent behavior looks off

Section titled “Agent behavior looks off”
  • Check local overrides in <repo>/.wld/agents/.
  • Check home overrides in ~/.wld/agents/.
  • Run /reload in the TUI after changing memories, settings, prompt templates, skills, models, or themes.