understand-dashboard

/understand-dashboard

Start the Understand Anything dashboard to visualize the knowledge graph for the current project.

Instructions

1. Determine the project directory and data directory:

   • If $ARGUMENTS contains a path, use that as the project directory
   • Otherwise, use the current working directory
   • Prefer the legacy .understand-anything/ data directory when it exists, otherwise use .ua/

   Use the Bash tool to resolve:

   PROJECT_ARG="$ARGUMENTS"
   if [ -n "$PROJECT_ARG" ]; then
     PROJECT_DIR=$(cd "$PROJECT_ARG" 2>/dev/null && pwd -P)
   else
     PROJECT_DIR=$(pwd -P)
   fi
   
   if [ -z "$PROJECT_DIR" ] || [ ! -d "$PROJECT_DIR" ]; then
     echo "Error: Project directory not found: ${PROJECT_ARG:-$PWD}"
     exit 1
   fi
   
   if [ -d "$PROJECT_DIR/.understand-anything" ]; then
     UA_DIR="$PROJECT_DIR/.understand-anything"
   else
     UA_DIR="$PROJECT_DIR/.ua"
   fi
   

2. Check that $UA_DIR/knowledge-graph.json exists in the project directory. If not, tell the user:

   No knowledge graph found. Run /understand first to analyze this project.
   

   Use the Bash tool to check:

   if [ ! -f "$UA_DIR/knowledge-graph.json" ]; then
     echo "No knowledge graph found. Run /understand first to analyze this project."
     exit 1
   fi
   

3. Find the dashboard code. The dashboard is at packages/dashboard/ relative to this plugin's root directory. Check these paths in order and use the first that exists:

   • ${CLAUDE_PLUGIN_ROOT}/packages/dashboard/ (Claude Code runtime root, highest priority)
   • ~/.understand-anything-plugin/packages/dashboard/ (universal symlink, all installs)
   • Two levels up from ~/.agents/skills/understand-dashboard real path (self-relative fallback)
   • Two levels up from ~/.copilot/skills/understand-dashboard real path (Copilot personal skills fallback)
   • Common clone-based install roots:
     • ~/.codex/understand-anything/understand-anything-plugin/packages/dashboard/
     • ~/.opencode/understand-anything/understand-anything-plugin/packages/dashboard/
     • ~/.pi/understand-anything/understand-anything-plugin/packages/dashboard/
     • ~/understand-anything/understand-anything-plugin/packages/dashboard/