Troubleshooting

Installation Issues

”Claude Code not found”

The claude CLI must be installed before Tandemu. Install it from code.claude.com .

Plugin not found after install

Restart Claude Code after running the plugin install commands. The plugin registry updates on restart.

install.sh permission denied


chmod +x install.sh
./install.sh

`/tandemu:setup` command not recognized

Exit and reopen Claude Code after installing the plugin. The setup skill is registered on restart.

Authentication Issues

Token expired

Re-run setup to get a fresh token (tokens expire after 30 days):

Plugin: run /tandemu:setup
Script: run ./install.sh

Wrong organization

Re-run /tandemu:setup and select a different organization when prompted.

Browser doesn’t open during auth

Copy the URL printed in the terminal output and open it manually in your browser.

401 Unauthorized from API

Your token may have expired or the API URL may be wrong. Check ~/.claude/tandemu.json for the correct api.url and re-run setup if needed.

Memory Issues

Memory server not responding

For Cloud users, check the Tandemu status page or try again in a few minutes.

For self-hosted users, check that the OpenMemory container is running — see the Self-Hosting guide.

No memories found

Memory starts empty for new users. Use Claude Code normally — memories are created passively as you work. You can also explicitly ask Claude to remember things.

Memories from another project appearing

Memory is scoped by user ID in the MCP URL. Check ~/.mcp.json to verify your user ID is correct.

Skill Issues

`/morning` shows no tasks

Check these in order:

Integration connected? — Go to the dashboard → Settings → Integrations
Project mapped to your team? — Check team-project mappings in the integration settings
Tasks assigned to you? — Verify tasks are assigned to your email in the ticket system
Correct team? — Check ~/.claude/tandemu.json for your team ID

`/finish` fails

API unreachable — Check that the Tandemu API is reachable and your token is valid
OTEL collector down — Telemetry will fail silently; the task still completes but metrics aren’t recorded
No active task — You must run /morning first to set an active task

Worktree already exists

A previous task wasn’t cleaned up. Remove the stale worktree manually:


git worktree remove .worktrees/<task-id> --force

Skills not found after install

Restart Claude Code. Skills are registered during setup and loaded on startup.

Dashboard Issues

Dashboard shows no data

Data appears after the first /finish completion. If you’ve completed tasks and still see no data, check that the OTEL endpoint in ~/.claude/settings.json is correct and your token is valid.

Wrong team data showing

Check the team filter in the dashboard header (top-right). Select the correct team or “All teams.”

Diagnostic Commands


# View Claude Code config
cat ~/.claude/tandemu.json | python3 -m json.tool
cat ~/.mcp.json | python3 -m json.tool

For self-hosted diagnostic commands (Docker, ClickHouse, OTEL collector), see the Self-Hosting guide.