Troubleshooting

Start with the health check and preserve its exact output:

npx selftune@latest doctor

Symptom	Check	Next action
Agent cannot see SelfTune	Was the skill installed after the session started?	Restart the agent session and ask it to inspect the installation
Command is missing	Is `npx` or Bun available?	Run through `npx selftune@latest` and record the version
Skills are missing	Are their directories visible to the current user and harness?	Check discovery paths without moving or copying skills yet
Health says no data	Has the skill been used in a supported recorded session?	Use it naturally, end the session, then run `sync` and `status`
Dashboard will not open	Is another runtime using the port or an older service registered?	Run `doctor` and inspect service status before restarting
Permission error	Which file, hook, history, or supervisor is blocked?	Grant only the narrow permission required or choose a manual path
Cloud or library fails	Is the local workflow healthy first?	Keep local operation working, then check URL, identity, and token separately

Collect a useful report

Include the SelfTune version, operating system, agent harness, installation path, exact command, exact error, expected result, and whether the problem also occurs through the CLI. Remove tokens, prompts, transcripts, usernames, and private filesystem paths before sharing a report.

Start

Manage your skills

Improve and validate

Run it your way

For agents

Concepts

Operate safely

Reference

Collect a useful report

​Collect a useful report

Collect a useful report