Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
TypeScript antigravity-skillsbusiness-knowledgeclaude-codeclaude-skillscodebase-analysiscodexcodex-skillsdeveloper-tools-ai-agentgemini-cli-skillskarpathy-llm-wikiknowledge-baseknowledge-graphmemoryopencode-skillspi-agentunderstandcodevibe-coding
<#
.SYNOPSIS
Understand-Anything installer for Windows (PowerShell).
.DESCRIPTION
Clones the repo and creates skill symlinks/junctions for the chosen platform.
.EXAMPLE
./install.ps1 # prompt for platform
./install.ps1 codex # install for codex
./install.ps1 -Update # pull latest changes
./install.ps1 -Uninstall codex # remove links for codex
#>
param(
[Parameter(Position = 0)]
[string]$Platform,
[switch]$Update,
[string]$Uninstall,
[switch]$Help
)
$ErrorActionPreference = 'Stop'
$RepoUrl = if ($env:UA_REPO_URL) { $env:UA_REPO_URL } else { 'https://github.com/Egonex-AI/Understand-Anything.git' }
$RepoDir = if ($env:UA_DIR) { $env:UA_DIR } else { Join-Path $HOME '.understand-anything\repo' }
$PluginLink = Join-Path $HOME '.understand-anything-plugin'
# Platform table - Target = skills directory; Style = "per-skill" | "folder"
$Platforms = [ordered]@{
gemini = @{ Target = (Join-Path $HOME '.agents\skills'); Style = 'per-skill' }
codex = @{ Target = (Join-Path $HOME '.agents\skills'); Style = 'per-skill' }
opencode = @{ Target = (Join-Path $HOME '.agents\skills'); Style = 'per-skill' }
pi = @{ Target = (Join-Path $HOME '.agents\skills'); Style = 'per-skill' }
openclaw = @{ Target = (Join-Path $HOME '.openclaw\skills'); Style = 'folder' }
antigravity = @{ Target = (Join-Path $HOME '.gemini\antigravity\skills'); Style = 'folder' }
vibe = @{ Target = (Join-Path $HOME '.vibe\skills'); Style = 'per-skill' }
vscode = @{ Target = (Join-Path $HOME '.copilot\skills'); Style = 'per-skill' }
hermes = @{ Target = (Join-Path $HOME '.hermes\skills'); Style = 'folder' }
cline = @{ Target = (Join-Path $HOME '.cline\skills'); Style = 'folder' }
kimi = @{ Target = (Join-Path $HOME '.kimi-code\skills'); Style = 'folder' }
trae = @{ Target = (Join-Path $HOME '.trae\skills'); Style = 'per-skill' }
nanobot = @{ Target = (Join-Path $HOME '.nanobot\workspace\skills'); Style = 'per-skill' }
kiro = @{ Target = (Join-Path $HOME '.kiro\skills'); Style = 'per-skill' }
devin = @{ Target = (Join-Path $HOME '.agents\skills'); Style = 'per-skill' }
}
function Show-Usage {
@"
Understand-Anything installer (Windows)
Usage:
install.ps1 [<platform>] Install for <platform> (or prompt if omitted)
install.ps1 -Update Pull latest changes
install.ps1 -Uninstall <platform> Remove links for <platform>
install.ps1 -Help
Supported platforms:
$($Platforms.Keys -join ', ')
Environment:
UA_REPO_URL Override clone URL
UA_DIR Override clone destination (default: %USERPROFILE%\.understand-anything\repo)
"@
}
function Resolve-Platform([string]$Id) {
if (-not $Platforms.Contains($Id)) {
Write-Error "Unknown platform: $Id. Supported: $($Platforms.Keys -join ', ')"
}
return $Platforms[$Id]
}
function Prompt-Platform {
$ids = @($Platforms.Keys)
Write-Host 'Which platform are you installing for?'
for ($i = 0; $i -lt $ids.Count; $i++) {
Write-Host (" {0}) {1}" -f ($i + 1), $ids[$i])
}
$choice = Read-Host ("Choose [1-{0}]" -f $ids.Count)
$n = 0
if (-not [int]::TryParse($choice, [ref]$n) -or $n -lt 1 -or $n -gt $ids.Count) {
Write-Error "Invalid choice: $choice"
}
return $ids[$n - 1]
}
function Get-SkillsRoot { Join-Path $RepoDir 'understand-anything-plugin\skills' }
function Clone-Or-Update {
if (Test-Path (Join-Path $RepoDir '.git')) {
Write-Host "-> Updating existing checkout at $RepoDir"
git -C $RepoDir pull --ff-only
} else {
Write-Host "-> Cloning $RepoUrl -> $RepoDir"
$parent = Split-Path -Parent $RepoDir
if (-not (Test-Path $parent)) { New-Item -ItemType Directory -Path $parent | Out-Null }
git clone $RepoUrl $RepoDir
}
}
function Get-SkillNames {
$root = Get-SkillsRoot
if (-not (Test-Path $root)) { Write-Error "Skills directory not found: $root" }
Get-ChildItem -Path $root -Directory | Select-Object -ExpandProperty Name
}
function Test-IsReparse([string]$Path) {
if (-not (Test-Path $Path)) { return $false }
$item = Get-Item -LiteralPath $Path -Force
return ($item.LinkType -eq 'Junction' -or $item.LinkType -eq 'SymbolicLink')
}
function Remove-Reparse([string]$Path) {
# Removes a junction/symlink without touching its target. Refuses to touch
# real files or directories so an existing user folder at the same path is
# never destroyed.
if (-not (Test-Path $Path)) { return $false }
$item = Get-Item -LiteralPath $Path -Force
if ($item.LinkType -eq 'Junction' -or $item.LinkType -eq 'SymbolicLink') {
$item.Delete()
return $true
}
Write-Warning "Refusing to delete $Path - it is a real file/directory, not a junction/symlink we created. Remove it manually if you intended to."
return $false
}
function New-Junction([string]$LinkPath, [string]$TargetPath) {
if (Test-Path $LinkPath) {
if (Test-IsReparse $LinkPath) {
(Get-Item -LiteralPath $LinkPath -Force).Delete()
} else {
Write-Error "Refusing to overwrite $LinkPath - it is a real file/directory, not a junction. Move or remove it first."
}
}
New-Item -ItemType Junction -Path $LinkPath -Target $TargetPath | Out-Null
}
function Link-Skills([string]$Target, [string]$Style) {
$root = Get-SkillsRoot
if (-not (Test-Path $Target)) { New-Item -ItemType Directory -Path $Target | Out-Null }
switch ($Style) {
'per-skill' {
foreach ($skill in Get-SkillNames) {
$link = Join-Path $Target $skill
$src = Join-Path $root $skill
New-Junction $link $src
Write-Host " OK $link -> $src"
}
}
'folder' {
$link = Join-Path $Target 'understand-anything'
New-Junction $link $root
Write-Host " OK $link -> $root"
}
default { Write-Error "Unknown style: $Style" }
}
}
function Unlink-Skills([string]$Target, [string]$Style) {
if (-not (Test-Path $Target)) { return }
switch ($Style) {
'per-skill' {
$skillsRoot = Get-SkillsRoot
if (Test-Path $skillsRoot) {
foreach ($skill in Get-SkillNames) {
Remove-Reparse (Join-Path $Target $skill) | Out-Null
}
} else {
# Checkout is gone - scan the target dir for stale links pointing
# into our plugin tree so we can still clean up.
Get-ChildItem -LiteralPath $Target -Force | ForEach-Object {
if ($_.LinkType -eq 'Junction' -or $_.LinkType -eq 'SymbolicLink') {
if ($_.Target -match 'understand-anything-plugin[\\/]+skills[\\/]+') {
Remove-Reparse $_.FullName | Out-Null
}
}
}
}
}
'folder' {
Remove-Reparse (Join-Path $Target 'understand-anything') | Out-Null
}
}
}
function Link-Plugin-Root {
if (Test-Path $PluginLink) {
Write-Host " * $PluginLink already exists, leaving as-is"
} else {
$src = Join-Path $RepoDir 'understand-anything-plugin'
New-Item -ItemType Junction -Path $PluginLink -Target $src | Out-Null
Write-Host " OK $PluginLink -> $src"
}
}
function ConvertTo-FileUri([string]$Path) {
# Produce a forward-slashed file URI (Windows: file:///C:/path/...).
return 'file:///' + ($Path -replace '\\', '/')
}
function Cmd-Install([string]$Id) {
$cfg = Resolve-Platform $Id
Clone-Or-Update
Write-Host "-> Linking skills for $Id ($($cfg.Style) -> $($cfg.Target))"
Link-Skills $cfg.Target $cfg.Style
Write-Host '-> Linking universal plugin root'
Link-Plugin-Root
if ($Id -eq 'kiro') {
Write-Host '-> Creating Kiro agent configuration'
$agentsDir = Join-Path $HOME '.kiro\agents'
if (-not (Test-Path $agentsDir)) { New-Item -ItemType Directory -Path $agentsDir | Out-Null }
$pluginRoot = Join-Path $RepoDir 'understand-anything-plugin'
# Build the "resources" list dynamically from the agent definitions in
# the repo so it never drifts as agents are added or removed.
$resources = @(
Get-ChildItem -Path (Join-Path $pluginRoot 'agents') -Filter '*.md' -File |
Sort-Object Name |
ForEach-Object { ConvertTo-FileUri $_.FullName }
)
$agent = [ordered]@{
name = 'understand'
description = 'Analyze codebase into interactive knowledge graph - Understand Anything'
prompt = ConvertTo-FileUri (Join-Path $pluginRoot 'skills\understand\SKILL.md')
tools = @('read', 'write', 'shell', 'grep', 'glob', 'code', 'subagent')
resources = $resources
}
$agentJson = Join-Path $agentsDir 'understand.json'
# WriteAllText emits UTF-8 without a BOM on every PowerShell version.
[System.IO.File]::WriteAllText($agentJson, ($agent | ConvertTo-Json -Depth 5))
Write-Host " OK $agentJson"
}
Write-Host "`nOK Installed Understand-Anything for $Id"
Write-Host ' Restart your CLI or IDE to pick up the skills.'
if ($Id -eq 'codex') {
Write-Host "`n Tip: Codex invokes skills with `$ instead of / - type `$understand, not /understand."
}
if ($Id -eq 'vscode') {
Write-Host "`n Tip: VS Code can also auto-discover the plugin by opening this repo"
Write-Host ' directly (it reads .copilot-plugin/plugin.json), no symlinks needed.'
}
if ($Id -eq 'kiro') {
Write-Host "`n Usage: kiro-cli chat --agent understand `"Analyze this project`""
}
if ($Id -eq 'devin') {
Write-Host "`n Tip: for auto-update hooks and the namespaced /understand-anything:* skills,"
Write-Host ' install as a Devin plugin instead:'
Write-Host ' devin plugins install Egonex-AI/Understand-Anything#understand-anything-plugin'
}
}
function Cmd-Uninstall([string]$Id) {
$cfg = Resolve-Platform $Id
Write-Host "-> Removing skill links for $Id"
Unlink-Skills $cfg.Target $cfg.Style
if ($Id -eq 'kiro') {
$agentJson = Join-Path $HOME '.kiro\agents\understand.json'
if (Test-Path $agentJson) {
Remove-Item -LiteralPath $agentJson -Force
Write-Host " OK removed $agentJson"
}
}
if (Remove-Reparse $PluginLink) {
Write-Host " OK removed $PluginLink"
}
if (Test-Path $RepoDir) {
Write-Host "`nThe checkout at $RepoDir was kept (other platforms may still use it)."
Write-Host "To remove it: Remove-Item -Recurse -Force '$RepoDir'"
}
}
function Cmd-Update {
if (-not (Test-Path (Join-Path $RepoDir '.git'))) {
Write-Error "No installation found at $RepoDir. Run install first."
}
git -C $RepoDir pull --ff-only
Write-Host 'OK Updated.'
}
if ($Help) { Show-Usage; return }
if ($Update) { Cmd-Update; return }
if ($Uninstall) { Cmd-Uninstall $Uninstall; return }
if (-not $Platform) { $Platform = Prompt-Platform }
Cmd-Install $Platform