# summary

Show the state of Cursor canvas cache entries.

# description

Lists each source canvas and its state in the Cursor cache: symlink pointing to the correct source (`symlink-ok`), symlink with a wrong target (`symlink-wrong`), a regular (possibly stale) file (`regular`), or absent from the cache (`missing`). Also reports orphan cache files with no repo counterpart.

# flags.path.summary

Target repository path (default: git root of current directory).

# examples

- Check canvas status for the current repo:

  <%= config.bin %> <%= command.id %>

# info.header

Project: %s Cache: %s

# warn.orphan

Orphan in cache (no repo counterpart): %s

# warn.cursorNotActive

cursor is not listed in workspace tools — canvas status may not be meaningful.

# error.noCacheDir

No Cursor canvas cache for this project. Expected: %s. Open a .canvas.tsx in Cursor first, or run canvas sync --init.

# error.noSources

No .canvas.tsx files found in %s. Searched: docs/canvases, canvases, src/canvases.