- name
- understand-dashboard
- description
- Launch the interactive web dashboard to visualize a codebase's knowledge graph
- argument-hint
- [project-path]
/understand-dashboard
Start the Understand Anything dashboard to visualize the knowledge graph for the current project.
Instructions
-
Determine the project directory and data directory:
- If
$ARGUMENTScontains 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 - If
-
Check that
$UA_DIR/knowledge-graph.jsonexists 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 -
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)${DEVIN_PLUGIN_ROOT}/packages/dashboard/(explicit override, when set)- Two levels up from this skill's own directory,
<SKILL_DIR>(the base directory your platform reported when loading this skill — covers plugin installs with no fixed location, such as Devin's) ~/.understand-anything-plugin/packages/dashboard/(universal symlink, all installs)- Two levels up from
~/.agents/skills/understand-dashboardreal path (self-relative fallback) - Two levels up from
~/.copilot/skills/understand-dashboardreal path (Copilot personal skills fallback) - Common clone-based install roots:
~/.codex/understand-anything/understand-anything-plugin/packages/dashboard/