Contenido de la habilidad

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

Instructions

Determine the project directory:
- If $ARGUMENTS contains a path, use that as the project directory
- Otherwise, use the current working directory
Check that .understand-anything/knowledge-graph.json exists in the project directory. If not, tell the user:
```
No knowledge graph found. Run /understand first to analyze this project.
```
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:
- ~/.understand-anything-plugin/packages/dashboard/ (universal symlink, all installs)
- ${CLAUDE_PLUGIN_ROOT}/packages/dashboard/ (Claude Code plugin)
- Two levels up from this skill file's real path: (self-relative fallback)

../../packages/dashboard/

SKILL_REAL=$(realpath ~/.agents/skills/understand-dashboard 2>/dev/null || readlink -f ~/.agents/skills/understand-dashboard 2>/dev/null || echo "")
SELF_RELATIVE=$([ -n "$SKILL_REAL" ] && cd "$SKILL_REAL/../.." 2>/dev/null && pwd || echo "")

PLUGIN_ROOT=""
for candidate in \
  "$HOME/.understand-anything-plugin" \
  "${CLAUDE_PLUGIN_ROOT}" \
  "$SELF_RELATIVE"; do
  if [ -n "$candidate" ] && [ -d "$candidate/packages/dashboard" ]; then
    PLUGIN_ROOT="$candidate"; break
  fi
done

if [ -z "$PLUGIN_ROOT" ]; then
  echo "Error: Cannot find the understand-anything plugin root. Make sure you followed the installation instructions and that ~/.understand-anything-plugin exists."
  exit 1
fi

Install dependencies and build if needed:

cd <dashboard-dir> && pnpm install --frozen-lockfile 2>/dev/null || pnpm install

Then ensure the core package is built (the dashboard depends on it):

cd <plugin-root> && pnpm --filter @understand-anything/core build

Start the Vite dev server pointing at the project's knowledge graph:

cd <dashboard-dir> && GRAPH_DIR=<project-dir> npx vite --host 127.0.0.1

Run this in the background so the user can continue working.

Capture the access token URL from the server output. The Vite server prints a line like:

🔑  Dashboard URL: http://127.0.0.1:<PORT>?token=<TOKEN>

Extract the full URL including the ?token= parameter. The token is required to access the knowledge graph data — without it the dashboard will show an "Access Token Required" gate.

Report to the user, including the full tokenized URL:

Dashboard started at http://127.0.0.1:<PORT>?token=<TOKEN>
Viewing: <project-dir>/.understand-anything/knowledge-graph.json

The dashboard is running in the background. Press Ctrl+C in the terminal to stop it.

Important: Always include the ?token= parameter in the URL you share. If you omit it, the user will be blocked by the token gate and have to manually find the token in the terminal output.

Understand Dashboard | Skills Pool

Understand Dashboard

Understand Dashboard

Instructions

Notes

Coding Agent (bash-first)

Install Vscode Extension

Launch

Agent Customization

Init

Launch