Skip to Content
Troubleshooting

Troubleshooting

If something isn’t working, start here. These are the most common issues and how to fix them.

Setup Issues

”claude: command not found”

What happened: Your terminal doesn’t know where Claude Code is installed.

Fix: Type this in your terminal:

source ~/.zshrc

Then try claude again. If it still doesn’t work, reinstall Claude Code following Step 1.

Commands aren’t showing up in Claude

What happened: Your custom commands aren’t linked properly.

Fix: Ask Claude directly:

Check if my commands are properly linked. Look in ~/.claude/commands/ and tell me what you find.

Claude will diagnose the issue and help you fix the symlinks.

1Password CLI won’t sign in

What happened: The 1Password CLI needs to be configured.

Fix:

op signin

If that doesn’t work, open the 1Password app first and make sure you’re logged in there. The CLI requires the desktop app to be running.

Connection Issues

Google Calendar or Gmail stopped working

What happened: Your login token expired (this happens periodically).

Fix: Ask Claude:

My Google Calendar connection stopped working. Help me re-authenticate.

Claude will walk you through refreshing your login.

GitHub commands fail

What happened: Your GitHub login needs refreshing.

Fix:

gh auth login

Follow the prompts to sign in again.

Daily Use Issues

Morning brief is missing or stale

What happened: The overnight automation didn’t run, or your context is outdated.

Fix: Run it manually:

claude

Then type: “Generate my morning brief.”

If the content seems outdated, also ask: “Refresh my context by reading my latest profile and vault files.”

The system gives generic responses (doesn’t know me)

What happened: Your profile isn’t loading, or it’s empty.

Fix: Check your profile:

claude

Then type: “Read my profile from ~/Vault/0_InnerContext/Self_Context/ and tell me what you know about me.”

If Claude doesn’t know much, go back to Step 3: Tell It About You and flesh out your profile.

Vault isn’t syncing (if using Obsidian Sync)

What happened: Obsidian Sync may have paused or encountered a conflict.

Fix: Open Obsidian, check the sync icon in the bottom-left corner. If it shows an error, click it for details. Usually restarting Obsidian resolves sync issues.

When All Else Fails

  1. Ask Claude. Describe your problem and Claude can usually diagnose and fix it:
claude

Then type: “I’m having trouble with [describe problem]. Help me diagnose and fix it.”

  1. Check the FAQ for common questions.

  2. Check the Developer Guide if you need technical details about how the system works under the hood.

What’s Next?

Last updated on
GlossaryFAQ