Skip to content
my-buddy

Common Issues

Section titled “Wiki links not resolving”

Problem: [[slug]] shows as broken link (red text).

Fix: The wiki-link index needs to be rebuilt:

Terminal window
bun build

This regenerates wiki-link-index.json and backlink-index.json. If the slug doesn’t exist in any collection, the link will remain broken — check the spelling.

Search not working

Section titled “Search not working”

Problem: Pressing / opens search but returns no results.

Fix: Pagefind needs a full build to create its index:

Terminal window
bun build

Search indexing only happens during the build step, not during bun dev.

Keyboard shortcuts not responding

Section titled “Keyboard shortcuts not responding”

Problem: Vim-style shortcuts (g p, j, k) don’t work.

Fix:

  • Make sure focus is not in a text input or search field
  • Press Escape first to clear any active state
  • Check that JavaScript is enabled in your browser
  • Press ? to see the help modal — if it appears, keyboard nav is loaded

Persona not activating

Section titled “Persona not activating”

Problem: Running /mybuddy.start doesn’t change Claude’s behavior.

Fix:

  • Verify buddy.config.ts exists and has valid persona settings
  • Make sure you’re running the command inside Claude Code
  • Check that the persona section has at least a name and tone set

Backup fails

Section titled “Backup fails”

Problem: /mybuddy.backup or bun data:backup fails.

Fix:

  • Verify the data repo exists at ../my-buddy-data (or your custom path)
  • Make sure the data repo is initialized with git init
  • Check the BUDDY_DATA_REPO environment variable if using a custom path
  • Ensure you have write permissions to the data repo directory

Frontmatter validation errors

Section titled “Frontmatter validation errors”

Problem: Build fails with Zod validation errors for content files.

Fix:

  • Check the error message for which field is invalid
  • Compare your frontmatter against the schema in Collections Overview
  • Common issues: missing required fields, wrong enum values, date format errors
  • Dates should be in YYYY-MM-DD format

Empty dashboard

Section titled “Empty dashboard”

Problem: Dashboard loads but shows no data.

Fix:

  • Content files must be in src/content/ with the correct collection directory
  • Files must have valid YAML frontmatter
  • Check that collections are enabled in buddy.config.ts
  • Run bun dev and check the terminal for any parsing errors