53 Commits

• docs(readme): note Cursor manual install fallback when auto-discovery fails

  Several users have reported that cloning the repo and opening it in Cursor
  doesn't always trigger auto-discovery of the .cursor-plugin manifest. Add
  the community-reported workaround (Cursor Settings → Plugins, paste repo
  URL) to the Cursor section so it isn't only discoverable from issue
  threads.
  
  Closes #172

  Asim Raza · 2026-05-24 10:43:18 +05:00
  0db7b3c795
• docs(readme): document incremental updates, subdir scoping, and tree-sitter+LLM split

  Add to all 8 READMEs (English + 7 translations):
  - "Keep learning" section gets inline commands for incremental re-runs, the --auto-update post-commit hook, and scoping /understand to a subdirectory for huge monorepos
  - "Under the Hood" gets a new "Tree-sitter + LLM hybrid" subsection explaining the deterministic-vs-semantic split that powers the pipeline

  Lum1104 · 2026-05-24 09:34:54 +08:00
  dbba0703a9
• feat(readme,homepage): add Trendshift badge

  Adds the Trendshift trending-repository badge just below the tagline on the
  English README and all 7 localized variants, and to the homepage hero between
  the action row and the Enterprise pill.

  Lum1104 · 2026-05-22 08:27:43 +08:00
  33728f04a6
• feat(readme,homepage): add Community section featuring Better Stack walkthrough video

  Adds a Community section near the end of README (English + 7 localized
  variants) and a CommunityVideo component on the homepage embedding the
  YouTube walkthrough by Better Stack. Section invites future video / blog /
  tutorial contributions to be featured here.

  Lum1104 · 2026-05-21 19:57:09 +08:00
  db94d066a8
• chore: remove Product Hunt promo from README and homepage hero
  Lum1104 · 2026-05-20 08:53:03 +08:00
  57a25ed4aa
• feat(i18n): add Russian language support
  Lum1104 · 2026-05-19 15:01:43 +08:00
  9d1318a0e7
• docs: Add --language parameter documentation to all READMEs
  zhushen · 2026-05-12 11:30:02 +08:00
  208921be3b
• feat(install): add KIMI CLI platform support (#134)

  KIMI CLI scans ~/.kimi/skills/ (its brand path) for SKILL.md per the
  official skill discovery spec, so distribution follows the same
  folder-symlink pattern as Hermes / Cline / OpenClaw. install.sh and
  install.ps1 register the `kimi` platform; README × 7 updated for the
  one-line install title, <platform> values, and compatibility table.
  
  Closes #134
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-05-11 22:11:48 +08:00
  31a775d65f
• feat(install): add Cline platform support (#116)

  Cline natively scans ~/.cline/skills/ for SKILL.md, so distribution
  follows the same folder-symlink pattern as Hermes / OpenClaw /
  Antigravity. install.sh and install.ps1 register the `cline` platform;
  README × 7 (English + 6 locales) updated for the one-line install
  title, <platform> values, and the compatibility table.
  
  Closes #116
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-05-11 22:10:37 +08:00
  b2fed42eac
• feat(install): add Hermes platform; refresh README (#91)

  - install.sh / install.ps1: register `hermes` platform (folder-style
    symlink to ~/.hermes/skills/understand-anything/). No new directories
    or plugin manifests needed — Hermes scans skills via os.walk(...,
    followlinks=True) and reads SKILL.md frontmatter directly.
  - README × 7 (English + 6 locales): one-line install title, `<platform>`
    values, and compatibility table updated for both Hermes and Vibe CLI
    (locale READMEs were missing Vibe).
  - README × 7: drop top-of-page Star History Rank badge and the TIP-style
    thanks blockquote; rewrite the slogan into a longer line about quietly
    teaching how the pieces fit; move a single italic thanks line between
    Star History and the MIT footer.
  - README × 7: remove the two outdated overview-*.gif blocks. The
    Features section already opens with a NOTE callout linking to the live
    demo, which serves as the visual entry instead.
  - Delete assets/overview-{structural,domain}.gif (8.1 MB of orphaned
    binaries) from the working tree.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-05-11 10:33:36 +08:00
  788aa90802
• add mistral vibe cli to install script
  3ng7n33r · 2026-05-07 14:16:07 +02:00
  4d23590621
• feat(install): unify per-platform installers into install.sh / install.ps1

  Replace 7 nearly-identical .<platform>/INSTALL.md files with one
  install.sh + install.ps1 that enumerate skills dynamically from
  understand-anything-plugin/skills/ — the previous hardcoded list of 6
  was already stale, missing understand-domain and understand-knowledge.
  
  Supported usage:
    install.sh <platform>            # gemini/codex/opencode/pi/openclaw/antigravity/vscode
    install.sh                       # interactive prompt; reads /dev/tty so curl|sh works
    install.sh --update              # git pull on the shared checkout
    install.sh --uninstall <plat>    # removes skill links for that platform
  
  Single shared checkout at ~/.understand-anything/repo (override via
  UA_DIR). Antigravity keeps its existing ~/.gemini/antigravity/skills
  path for backward compatibility; OpenClaw keeps its folder-symlink
  style. Universal ~/.understand-anything-plugin link unchanged.
  
  README.md and the 6 translated READMEs replace the old per-platform
  "Fetch and follow instructions from .../<plat>/INSTALL.md" blocks with
  a single curl|sh / iwr|iex one-liner. Compatibility tables updated.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-05-06 22:53:23 +08:00
  8956696228
• docs: collect translated READMEs into READMEs/ folder

  - Move 6 non-English READMEs (zh-CN, zh-TW, ja-JP, ko-KR, es-ES, tr-TR)
    into a new READMEs/ folder; the English README stays at the repo root
  - Rewrite asset paths in the moved files: assets/* -> ../assets/*
  - Rewrite the English link in each translated language switcher to
    ../README.md; sibling links stay the same name (now both in READMEs/)
  - Update the English README's language switcher to point to
    READMEs/README.xx.md for each translation
  
  No version bump — file reorganization only.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-05-05 18:43:18 +08:00
  b9ca060613
• docs(homepage): add Discord and enterprise contact

  - Hero CTA row: blurple "Join Discord" button alongside Get Started
  - Hero pill below CTAs: "ENTERPRISE · lum@understand-anything.com →"
    mirroring the badge style at the top of the hero
  - Footer: add Discord and Contact (mailto) links to the link list
  - READMEs (en, zh-CN, zh-TW, ja, ko, es, tr): replace the small
    flat-square Discord badge with a prominent text link below the hero
    image: "💬 Join the Discord community →" plus a translated tagline.
  
  No version bump — content/copy only.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-05-05 16:52:13 +08:00
  5cef66c5c5
• docs: add Discord join badge to all README locales

  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-26 16:58:14 +08:00
  d3c2c65b86
• docs: update claude code link to claude code plugin in README
  gustn99 · 2026-04-25 12:15:56 +09:00
  e68f651fb0
• update hero image
  Lum1104 · 2026-04-24 15:52:03 +08:00
  de626527e4
• docs: point homepage links at understand-anything.com

  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-19 12:33:42 +08:00
  92ee9e3dbb
• docs: add "Share the Graph with Your Team" section to READMEs (#79)
  Lum1104 · 2026-04-17 11:05:06 +08:00
  38a0e3e2e1
• fix: correct live demo URLs in all READMEs to point to /demo/

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-14 12:22:45 +08:00
  a42ba9119a
• feat: embed live demo in homepage and add demo link to all READMEs

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-14 12:12:19 +08:00
  dc84b07159
• docs: add "graphs that teach > graphs that impress" tagline to all READMEs

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-13 00:34:37 +08:00
  ba461006ce
• docs: add Copilot CLI installation instructions to all README translations

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-12 19:57:00 +08:00
  569ed2a1c7
• docs: add Korean and Spanish README translations

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-12 11:31:46 +08:00
  c2f5b02b2d
• docs: add /understand-knowledge to README

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-12 11:12:38 +08:00
  66a8706646
• docs: add Star History rank badge to all READMEs

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-11 09:19:13 +08:00
  55a03f6647
• docs: add platform badges for Codex, Copilot, Gemini CLI, OpenCode

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-09 18:58:22 +08:00
  003339ec88
• docs: add animated showcase GIFs and streamline READMEs

  - Replace static overview.png with two animated GIFs (structural + domain views)
  - Reorder READMEs: Features section before Quick Start
  - Remove redundant sections (Why, Who is this for, duplicate feature entries)
  - Move project structure/tech stack/dev commands to CONTRIBUTING.md
  - Homepage: use Supabase-hosted MP4 videos via GitHub variables, GIF fallback
  - Add DEMO_STRUCTURAL_VIDEO_URL and DEMO_DOMAIN_VIDEO_URL to deploy workflow
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-09 18:42:51 +08:00
  7e40b6d03a
• docs: update README tagline with expanded input types and multi-platform support

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-09 00:46:39 +08:00
  04972b63f6
• docs: add live demo badge and switch to default rounded badges across all READMEs

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-03 11:55:01 +08:00
  3dfacd1c43
• docs: add business domain knowledge feature to all README translations

  Add /understand-domain command, domain-analyzer agent, and two new
  feature entries (Business Domain Knowledge + Structural/Domain Views)
  to all 5 README versions: English, Simplified Chinese, Traditional
  Chinese, Japanese, and Turkish.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-04-03 00:10:01 +08:00
  87cfe0d869
• docs: add Traditional Chinese README and update language links

  - Add README.zh-TW.md (Traditional Chinese translation)
  - Update language nav links in all READMEs to include 繁體中文
  
  Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

  Garfield · 2026-03-29 20:42:25 +08:00
  631dc588f8
• feat: add VS Code + GitHub Copilot agent skills support

  - Add `.copilot-plugin/plugin.json` for auto-discovery in VS Code (mirrors `.cursor-plugin/` format)
  - Add `.vscode/INSTALL.md` with two install options: auto-discovery and personal skills via symlink
  - Update README.md and README.zh-CN.md with VS Code section and compatibility table row
  
  Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

  Garfield · 2026-03-29 13:09:00 +08:00
  ea3e42a836
• docs: update README pipeline stats — concurrency 3→5, batch size, --review flag

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-27 17:23:09 +08:00
  b90fb16b01
• docs: add Gemini CLI and Pi Agent platform support

  Add INSTALL.md for Gemini CLI and Pi Agent, and update all four
  READMEs (EN, ZH, JA, TR) with install instructions and compatibility
  table entries.
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-24 18:43:53 +08:00
  bc9ab3f090
• Merge branch 'Lum1104:main' into feat/keyboard-shortcuts-and-contributing
  Berkcan Gümüşışık · 2026-03-23 15:59:03 +03:00
  59b755ca46
• Add Turkish README and update language links

  Add a new Turkish translation file README.tr-TR.md with the full localized documentation and quickstart instructions. Update README.md to include a link to the Turkish README in the language selector so Turkish-speaking users can access the translated docs.

  Berkcan Gümüşışık · 2026-03-23 11:57:23 +03:00
  25ebf6d950
• refactor: unify skills install method across all platforms

  Replace platform-specific install approaches with a consistent
  per-skill symlink pattern for OpenCode and Codex (both share
  ~/.agents/skills/), matching the OpenCode docs requirement of
  <name>/SKILL.md discovery.
  
  Changes:
  - OpenCode: migrate from opencode.json plugin config to direct
    skill symlinks in ~/.agents/skills/<name>/
  - Codex: replace broken bundle symlink (understand-anything/ had
    no SKILL.md at root) with individual per-skill symlinks, matching
    OpenCode exactly
  - All platforms: add universal ~/.understand-anything-plugin symlink
    so understand-dashboard SKILL.md can reliably find packages/dashboard/
  - All platforms: use idempotent [ -e ] || [ -L ] || ln -s guard to
    handle multi-platform installs on the same machine
  - All platforms: use ln -sf and rm -f for robust re-installs and
    partial uninstalls
  - understand-dashboard/SKILL.md: replace fragile dirname-based path
    resolution with a prioritized candidate loop with explicit error
    guard
  - Remove orphaned .opencode/plugins/understand-anything.js and its
    build scaffolding
  - Update all three README variants (en, zh-CN, ja-JP) to reflect
    new OpenCode AI-driven install method
  
  Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-23 16:41:29 +08:00
  c8d92444e2
• docs: add Japanese README
  Ikko Ashimine · 2026-03-23 12:33:59 +09:00
  1aa29897b2
• feat: add Antigravity installation guide and update README with compatibility information.
  longvv · 2026-03-21 16:33:07 +07:00
  18c0fcd9eb
• docs: thanks
  Lum1104 · 2026-03-20 19:16:47 +08:00
  9866fccae9
• Add Chinese language support
  Jamie-HM · 2026-03-20 12:23:51 +08:00
  a38843d57e
• docs: add star history and bump version to 1.1.0
  Lum1104 · 2026-03-19 23:48:26 +08:00
  54259f3b86
• docs: update multi-platform URLs after moving configs to root

  Update raw GitHub URLs in README to remove understand-anything-plugin/
  prefix for Codex and OpenClaw INSTALL.md paths. Replace Cursor section
  with auto-discovery via .cursor-plugin/plugin.json.
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-19 23:18:42 +08:00
  fb46373cef
• docs: add multi-platform installation instructions to README

  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Lum1104 · 2026-03-19 10:51:25 +08:00
  8e3c0660c9
• feat(homepage): add cinematic project homepage with GitHub Pages deployment

  Astro-based static homepage with dark luxury theme, self-hosted fonts,
  scroll-reveal animations, and GitHub Actions CI/CD to Pages.
  
  Sections: Nav, Hero, Dashboard Showcase, Feature Cards, Install CTA, Footer.
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-15 20:26:49 +08:00
  e862b9a1da
• docs: add hero image and dashboard screenshot to README
  Lum1104 · 2026-03-15 16:53:55 +08:00
  dda6547809
• feat: redesign dashboard with dark luxury theme, improve agent pipeline

  - Remove ChatPanel and @anthropic-ai/sdk dependency (redundant with /understand-chat)
  - Replace Monaco editor with styled summary code viewer
  - New graph-first layout: 75% graph + 360px right sidebar
  - Dark luxury aesthetic: deep blacks, gold/amber accents, DM Serif Display typography
  - Add ProjectOverview component for sidebar default state
  - Learn persona now shows tour panel directly in sidebar
  - Add schema validation on graph load with error banner
  - Defensive null checks in store for tour methods
  - Agent pipeline: write intermediate results to disk instead of context
  - Agent models: sonnet for simple tasks, opus for complex (no haiku)
  - Prompt-engineer all 5 agent prompts and SKILL.md
  - Auto-trigger /understand-dashboard after /understand completes
  - Add dashboard screenshot to README
  - Bump version to 1.0.1
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-15 12:36:39 +08:00
  343e94c9a7
• refactor: restructure monorepo into Claude Code plugin layout

  Move packages/{core,dashboard,skill} into understand-anything-plugin/ to
  conform to the Claude Code plugin format. Add .claude-plugin/marketplace.json
  for plugin discovery. Update workspace config and docs accordingly.
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-15 11:16:43 +08:00
  b75235919e
• fix(dashboard): auto-detect knowledge graph from .understand-anything/

  The Vite dev server now looks for .understand-anything/knowledge-graph.json
  in the project root, so users don't need to manually copy the graph file
  into public/. Also updates README with clearer installation and usage
  instructions, and adds dashboard viewing steps to /understand SKILL.md.
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

  Lum1104 · 2026-03-15 00:30:34 +08:00
  f69ad5887e