understand-dashboard

1# /understand-dashboard
2 
3Start the Understand Anything dashboard to visualize the knowledge graph for the current project.
4 
5## Instructions
6 
71. Determine the project directory and data directory:
8   - If `$ARGUMENTS` contains a path, use that as the project directory
9   - Otherwise, use the current working directory
10   - Prefer the legacy `.understand-anything/` data directory when it exists, otherwise use `.ua/`
11 
12   Use the Bash tool to resolve:
13   ```bash
14   PROJECT_ARG="$ARGUMENTS"
15   if [ -n "$PROJECT_ARG" ]; then
16     PROJECT_DIR=$(cd "$PROJECT_ARG" 2>/dev/null && pwd -P)
17   else
18     PROJECT_DIR=$(pwd -P)
19   fi
20 
21   if [ -z "$PROJECT_DIR" ] || [ ! -d "$PROJECT_DIR" ]; then
22     echo "Error: Project directory not found: ${PROJECT_ARG:-$PWD}"
23     exit 1
24   fi
25 
26   if [ -d "$PROJECT_DIR/.understand-anything" ]; then
27     UA_DIR="$PROJECT_DIR/.understand-anything"
28   else
29     UA_DIR="$PROJECT_DIR/.ua"
30   fi
31   ```
32 
332. Check that `$UA_DIR/knowledge-graph.json` exists in the project directory. If not, tell the user:
34   ```
35   No knowledge graph found. Run /understand first to analyze this project.
36   ```
37 
38   Use the Bash tool to check:
39   ```bash
40   if [ ! -f "$UA_DIR/knowledge-graph.json" ]; then
41     echo "No knowledge graph found. Run /understand first to analyze this project."
42     exit 1
43   fi
44   ```
45 
463. 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:
47…