# Troubleshooting

## Resource Does Not Appear

- Run the verify script.
- Confirm the resource exists in the repository.
- Confirm the default discovery link exists.
- Use VS Code Chat Diagnostics to confirm the resource is being loaded.

## Changed Resource Does Not Reload

Treat hot reload as likely but not guaranteed. If needed:

- start a new chat session
- restart the Copilot CLI session
- reopen VS Code

## Session Start Hook Permission Denied

If you see `/bin/sh: .../report-hook-event.sh: Permission denied` when a Copilot
session starts:

- Pull the latest repo changes and rerun `install/update.sh`.
- If you need to refresh links and generated config without pulling, rerun
	`install/bootstrap.sh`.
- Run `install/verify.sh --quick` and resolve any missing managed files it
	reports.
- Start a new Copilot session and confirm
	`~/.copilot-resources-state/hook-events.log` receives a new JSON line.

The shared hook now invokes the shell script through `bash`, so the session
start hook no longer depends on the script file itself being executable.

## Publish Refused To Overwrite

The publish scripts stop on collisions by default. Use a new name or rerun with
`--force` only after confirming the replacement is intentional.