oh-my-lsp 0.1.1

package/.claude/settings.local.json

@@ -0,0 +1,27 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx oh-my-lsp:*)",
+      "Bash(git checkout:*)",
+      "Bash(npx vitest:*)",
+      "Bash(git:*)",
+      "Bash(npm run:*)",
+      "Bash(command:*)",
+      "Bash(gh run:*)",
+      "Bash(ruby-lsp:*)",
+      "Bash(mkdir:*)",
+      "Bash(ruby:*)",
+      "Bash(npm install:*)",
+      "Bash(npm test:*)",
+      "Bash(npx tsx:*)",
+      "Bash(npx tsc:*)",
+      "Bash(bash-language-server:*)",
+      "Bash(shellcheck:*)",
+      "Bash(OH_MY_LSP_VERBOSE=1 node:*)"
+    ]
+  },
+  "enableAllProjectMcpServers": true,
+  "enabledMcpjsonServers": [
+    "exa"
+  ]
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,382 @@
+name: CI
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run test suite
+        run: npm run test
+
+  ast-grep-cli-tests:
+    name: ast-grep-cli-tests
+    needs: test
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install ast-grep
+        run: npm install -g @ast-grep/cli
+
+      - name: Verify ast-grep installation
+        run: command -v sg
+
+      - name: Run ast-grep search integration test
+        run: npm run test:cli:ast-grep-search
+
+      - name: Run ast-grep replace integration test
+        run: npm run test:cli:ast-grep-replace
+
+  language-cli-tests-1:
+    name: language-cli-tests-1 (${{ matrix.language }})
+    needs: test
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [java, kotlin, go, ruby]
+
+    steps: &language_cli_tests_steps
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build CLI
+        run: npm run build
+
+      - name: Verify install hint shown before server is installed
+        run: |
+          set -euo pipefail
+          LANG="${{ matrix.language }}"
+
+          case "$LANG" in
+            java) FILE="tests/fixtures/java/App.java" ;;
+            rust) FILE="tests/fixtures/rust/diagnostics_fail.rs" ;;
+            *)    FILE="$(find "tests/fixtures/$LANG" -maxdepth 1 -name 'sample.*' | head -n 1)" ;;
+          esac
+
+          if [ -z "$FILE" ]; then
+            echo "SKIP: no fixture file found for '$LANG'"
+            exit 0
+          fi
+
+          OUTPUT=$(node dist/index.js diagnostics "$FILE" 2>&1 || true)
+          if echo "$OUTPUT" | grep -q "NOT INSTALLED"; then
+            echo "PASS: '$LANG' correctly shows NOT INSTALLED hint"
+          elif echo "$OUTPUT" | grep -q "exited immediately"; then
+            echo "PASS: '$LANG' server found but exited (install hint shown for crash)"
+          else
+            echo "SKIP: '$LANG' server may already be pre-installed on this runner"
+            echo "Output: $OUTPUT"
+          fi
+
+      - name: Setup Java
+        if: matrix.language == 'java' || matrix.language == 'kotlin'
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '21'
+
+      - name: Setup Go
+        if: matrix.language == 'go'
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.23'
+          cache: false
+
+      - name: Setup .NET
+        if: matrix.language == 'csharp'
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Install TypeScript language server
+        if: matrix.language == 'typescript' || matrix.language == 'javascript'
+        run: npm install -g typescript-language-server typescript
+
+      - name: Install jdtls
+        if: matrix.language == 'java'
+        run: |
+          set -euo pipefail
+
+          if command -v jdtls >/dev/null 2>&1; then
+            exit 0
+          fi
+
+          sudo apt-get update
+          if sudo apt-get install -y jdtls; then
+            exit 0
+          fi
+
+          mkdir -p "$HOME/.local/jdtls"
+          curl -fsSL "https://download.eclipse.org/jdtls/snapshots/jdt-language-server-latest.tar.gz" -o /tmp/jdtls.tar.gz
+          tar -xzf /tmp/jdtls.tar.gz -C "$HOME/.local/jdtls"
+          JDTLS_BIN="$(find "$HOME/.local/jdtls" -type f -name jdtls | head -n 1)"
+          if [ -z "$JDTLS_BIN" ]; then
+            echo "jdtls binary not found after fallback installation"
+            exit 1
+          fi
+          chmod +x "$JDTLS_BIN"
+          echo "$(dirname "$JDTLS_BIN")" >> "$GITHUB_PATH"
+
+      - name: Install Python language server
+        if: matrix.language == 'python'
+        run: npm install -g pyright
+
+      - name: Install PHP language server
+        if: matrix.language == 'php'
+        run: npm install -g intelephense
+
+      - name: Install Go language server
+        if: matrix.language == 'go'
+        run: go install golang.org/x/tools/gopls@latest
+
+      - name: Install C/C++ language server
+        if: matrix.language == 'c' || matrix.language == 'cpp'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clangd
+
+      - name: Install C# language server
+        if: matrix.language == 'csharp'
+        run: |
+          dotnet tool install -g csharp-ls
+          echo "$HOME/.dotnet/tools" >> "$GITHUB_PATH"
+
+      - name: Install CSS language server
+        if: matrix.language == 'css'
+        run: npm install -g @biomejs/biome
+
+      - name: Install Bash language server
+        if: matrix.language == 'bash'
+        run: npm install -g bash-language-server
+
+      - name: Install YAML language server
+        if: matrix.language == 'yaml'
+        run: npm install -g yaml-language-server
+
+      - name: Install Dockerfile language server
+        if: matrix.language == 'dockerfile'
+        run: npm install -g dockerfile-language-server-nodejs
+
+      - name: Install Ruby language server
+        if: matrix.language == 'ruby'
+        run: |
+          set -euo pipefail
+          if ! command -v gem >/dev/null 2>&1; then
+            sudo apt-get update
+            sudo apt-get install -y ruby-full
+          fi
+          sudo gem install bundler ruby-lsp
+          GEM_BIN_DIR="$(ruby -r rubygems -e 'puts Gem.default_bindir')"
+          echo "$GEM_BIN_DIR" >> "$GITHUB_PATH"
+
+      - name: Install Rust language server
+        if: matrix.language == 'rust'
+        run: |
+          set -euo pipefail
+          if command -v rustup >/dev/null 2>&1; then
+            rustup component add rust-analyzer
+          fi
+          if ! command -v rust-analyzer >/dev/null 2>&1; then
+            sudo apt-get update
+            sudo apt-get install -y rust-analyzer
+          fi
+
+      - name: Install Kotlin language server
+        if: matrix.language == 'kotlin'
+        run: |
+          set -euo pipefail
+          if command -v kotlin-lsp >/dev/null 2>&1; then
+            exit 0
+          fi
+          KOTLIN_LSP_ZIP_URL="$(curl -fsSL https://github.com/Kotlin/kotlin-lsp/releases/latest | grep -o 'https://download-cdn.jetbrains.com/kotlin-lsp[^\" ]*linux-x64.zip' | head -n 1)"
+          if [ -z "$KOTLIN_LSP_ZIP_URL" ]; then
+            echo "Failed to resolve Kotlin LSP Linux artifact URL"
+            exit 1
+          fi
+          mkdir -p "$HOME/.local/kotlin-lsp" "$HOME/.local/bin"
+          curl -fsSL "$KOTLIN_LSP_ZIP_URL" -o /tmp/kotlin-lsp.zip
+          unzip -q -o /tmp/kotlin-lsp.zip -d "$HOME/.local/kotlin-lsp"
+          KOTLIN_LSP_SH="$(find "$HOME/.local/kotlin-lsp" -type f -name 'kotlin-lsp.sh' | head -n 1)"
+          if [ -z "$KOTLIN_LSP_SH" ]; then
+            echo "kotlin-lsp.sh not found after extraction"
+            exit 1
+          fi
+          chmod +x "$KOTLIN_LSP_SH"
+          ln -sf "$KOTLIN_LSP_SH" "$HOME/.local/bin/kotlin-lsp"
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+
+      - name: Install Lua language server
+        if: matrix.language == 'lua'
+        run: |
+          set -euo pipefail
+          if ! command -v lua-language-server >/dev/null 2>&1; then
+            sudo apt-get update
+            if ! sudo apt-get install -y lua-language-server; then
+              LUA_LS_TAG="$(curl -sI https://github.com/LuaLS/lua-language-server/releases/latest | tr -d '\r' | awk -F'/' '/^location:/{print $NF}' | tail -n 1)"
+              if [ -z "$LUA_LS_TAG" ]; then
+                echo "Failed to resolve LuaLS latest release tag"
+                exit 1
+              fi
+              LUA_LS_URL="https://github.com/LuaLS/lua-language-server/releases/download/${LUA_LS_TAG}/lua-language-server-${LUA_LS_TAG}-linux-x64.tar.gz"
+              mkdir -p "$HOME/.local/lua-language-server" "$HOME/.local/bin"
+              curl -fsSL "$LUA_LS_URL" -o /tmp/lua-language-server.tar.gz
+              tar -xzf /tmp/lua-language-server.tar.gz -C "$HOME/.local/lua-language-server"
+              chmod +x "$HOME/.local/lua-language-server/bin/lua-language-server"
+              ln -sf "$HOME/.local/lua-language-server/bin/lua-language-server" "$HOME/.local/bin/lua-language-server"
+              echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+            fi
+          fi
+
+      - name: Verify server installation (TypeScript)
+        if: matrix.language == 'typescript'
+        run: command -v typescript-language-server
+
+      - name: Verify server installation (JavaScript)
+        if: matrix.language == 'javascript'
+        run: command -v typescript-language-server
+
+      - name: Verify server installation (Java)
+        if: matrix.language == 'java'
+        run: command -v jdtls
+
+      - name: Verify server installation (Python)
+        if: matrix.language == 'python'
+        run: command -v pyright-langserver
+
+      - name: Verify server installation (PHP)
+        if: matrix.language == 'php'
+        run: command -v intelephense
+
+      - name: Verify server installation (Go)
+        if: matrix.language == 'go'
+        run: command -v gopls
+
+      - name: Verify server installation (C)
+        if: matrix.language == 'c'
+        run: command -v clangd
+
+      - name: Verify server installation (C++)
+        if: matrix.language == 'cpp'
+        run: command -v clangd
+
+      - name: Verify server installation (C#)
+        if: matrix.language == 'csharp'
+        run: command -v csharp-ls
+
+      - name: Verify server installation (CSS)
+        if: matrix.language == 'css'
+        run: command -v biome
+
+      - name: Verify server installation (Bash)
+        if: matrix.language == 'bash'
+        run: command -v bash-language-server
+
+      - name: Verify server installation (YAML)
+        if: matrix.language == 'yaml'
+        run: command -v yaml-language-server
+
+      - name: Verify server installation (Dockerfile)
+        if: matrix.language == 'dockerfile'
+        run: command -v docker-langserver
+
+      - name: Verify server installation (Ruby)
+        if: matrix.language == 'ruby'
+        run: command -v ruby-lsp
+
+      - name: Preflight ruby-lsp startup (debug)
+        if: matrix.language == 'ruby'
+        run: |
+          mkdir -p /tmp/ruby-lsp-debug
+          cd /tmp/ruby-lsp-debug
+          ruby-lsp 2>&1 &
+          RUBY_PID=$!
+          sleep 10
+          kill "$RUBY_PID" 2>/dev/null || true
+          wait "$RUBY_PID" 2>/dev/null || true
+          echo "Preflight done (exit ignored)"
+
+      - name: Verify server installation (Rust)
+        if: matrix.language == 'rust'
+        run: command -v rust-analyzer
+
+      - name: Verify server installation (Kotlin)
+        if: matrix.language == 'kotlin'
+        run: command -v kotlin-lsp
+
+      - name: Verify server installation (Lua)
+        if: matrix.language == 'lua'
+        run: command -v lua-language-server
+
+      - name: Run CLI integration test
+        run: npm run test:cli:${{ matrix.language }}
+
+  language-cli-tests-2:
+    name: language-cli-tests-2 (${{ matrix.language }})
+    needs: language-cli-tests-1
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [typescript, javascript, python, php, lua]
+    steps: *language_cli_tests_steps
+
+  language-cli-tests-fail:
+    name: language-cli-tests-fail (${{ matrix.language }})
+    needs: test
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [rust, csharp]
+    steps: *language_cli_tests_steps
+
+  language-cli-tests-3:
+    name: language-cli-tests-3 (${{ matrix.language }})
+    needs: language-cli-tests-2
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [c, cpp, css, bash, yaml, dockerfile]
+    steps: *language_cli_tests_steps

package/AGENTS.md

@@ -0,0 +1,18 @@
+# AGENTS.md
+
+## When Does `oh-my-lsp` Skill Apply?
+
+The `oh-my-lsp` skill **MUST** be activated when the task involves any of:
+- Finding definitions, references, or symbols
+- Inspecting diagnostics (errors/warnings)
+- Renaming symbols
+- AST-aware pattern search or replace
+
+## Enforcement Rule
+
+If a task involves:
+- Semantic symbol operations → LSP commands must be used.
+- Structural pattern transformations → AST-Grep must be used.
+- Any modification to LSP-supported files → `diagnostics` must run before and after.
+
+Failure to follow these sequences is considered non-compliant.

package/CLAUDE.md

@@ -0,0 +1,18 @@
+# AGENTS.md
+
+## When Does `oh-my-lsp` Skill Apply?
+
+The `oh-my-lsp` skill **MUST** be activated when the task involves any of:
+- Finding definitions, references, or symbols
+- Inspecting diagnostics (errors/warnings)
+- Renaming symbols
+- AST-aware pattern search or replace
+
+## Enforcement Rule
+
+If a task involves:
+- Semantic symbol operations → LSP commands must be used.
+- Structural pattern transformations → AST-Grep must be used.
+- Any workspace modification → `diagnostics` must run before and after.
+
+Failure to follow these sequences is considered non-compliant.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 oh-my-lsp contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,223 @@
+# oh-my-lsp CLI
+
+Built by referencing `oh-my-opencode`'s [`src/tools/ast-grep`](https://github.com/code-yeongyu/oh-my-opencode/dev/src/tools/ast-grep), [`src/tools/lsp`](https://github.com/code-yeongyu/oh-my-opencode/dev/src/tools/lsp).
+
+## Prerequisites
+
+`oh-my-lsp` does **not** bundle language servers or ast-grep. You must install them separately.
+
+### ast-grep (required for `ast_grep_search` / `ast_grep_replace`)
+
+```bash
+npm install -g @ast-grep/cli
+# or
+cargo install ast-grep --locked
+# or
+brew install ast-grep
+```
+
+### LSP Servers (required for LSP commands)
+
+Install the server for each language you need:
+
+| Language | Install |
+|----------|---------|
+| TypeScript/JS | `npm install -g typescript-language-server typescript` |
+| Python | `pip install basedpyright` or `pip install pyright` |
+| Go | `go install golang.org/x/tools/gopls@latest` |
+| Rust | `rustup component add rust-analyzer` |
+| Java | See [eclipse.jdt.ls](https://github.com/eclipse-jdtls/eclipse.jdt.ls) |
+| C/C++ | See [clangd](https://clangd.llvm.org/installation) |
+| Ruby | `gem install ruby-lsp` |
+| PHP | `npm install -g intelephense` |
+| Bash | `npm install -g bash-language-server` (also install `shellcheck` for diagnostics) |
+| Kotlin | See [kotlin-lsp](https://github.com/Kotlin/kotlin-lsp) |
+| C# | `dotnet tool install -g csharp-ls` |
+| Lua | See [lua-language-server](https://github.com/LuaLS/lua-language-server) |
+| YAML | `npm install -g yaml-language-server` |
+| Dockerfile | `npm install -g dockerfile-language-server-nodejs` |
+| CSS/HTML | `npm install -g @biomejs/biome` |
+| Vue | `npm install -g @vue/language-server` |
+| Svelte | `npm install -g svelte-language-server` |
+| Elixir | See [elixir-ls](https://github.com/elixir-lsp/elixir-ls) |
+| Haskell | `ghcup install hls` |
+
+> For the full list of built-in servers and install hints, see [`src/lsp/server-definitions.ts`](src/lsp/server-definitions.ts).
+
+## Getting Started
+
+```bash
+npm install oh-my-lsp
+```
+
+Run directly:
+
+```bash
+npx oh-my-lsp diagnostics src/index.ts
+```
+
+## Run in Development
+
+```bash
+npm run dev -- --help
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+## Test
+
+```bash
+npm run test
+```
+
+## Commands
+
+Basic format:
+
+```bash
+oh-my-lsp <command> <args...>
+```
+
+### For AI Agents
+
+If you are using `oh-my-lsp` with an AI coding agent (e.g. Claude Code, Cursor, Windsurf), add the following to your project's `CLAUDE.md` or `AGENTS.md` to enforce correct tool usage:
+
+```markdown
+## When Does `oh-my-lsp` Skill Apply?
+
+The `oh-my-lsp` skill **MUST** be activated when the task involves any of:
+- Finding definitions, references, or symbols
+- Inspecting diagnostics (errors/warnings)
+- Renaming symbols
+- AST-aware pattern search or replace
+
+## Enforcement Rule
+
+If a task involves:
+- Semantic symbol operations → LSP commands must be used.
+- Structural pattern transformations → AST-Grep must be used.
+- Any modification to LSP-supported files → `diagnostics` must run before and after.
+
+Failure to follow these sequences is considered non-compliant.
+```
+
+### LSP Tools (IDE Features for Agents)
+
+| Tool | Description |
+|------|-------------|
+| **diagnostics** | Get errors/warnings before build |
+| **prepare_rename** | Validate rename operation |
+| **rename** | Rename symbol across workspace |
+| **goto_definition** | Jump to symbol definition |
+| **find_references** | Find all usages across workspace |
+| **symbols** | Get file outline or workspace symbol search |
+
+### Language-specific LSP Command Coverage
+
+| Language | `symbols` | `diagnostics` | `goto_definition` | `find_references` | `prepare_rename` | `rename` | verify |
+|---|---|---|---|---|---|---|---|
+| Bash | O | O | O | O | O | O | ✅ |
+| C | O | O | O | O | O | O | ✅ |
+| C++ | O | O | O | O | O | O | ✅ |
+| C# | O | O | O | O | O | O | |
+| CSS | X | O | X | X | X | X | ✅ |
+| Dockerfile | O | O | X | X | X | X | ✅ |
+| Go | O | O | O | O | O | O | |
+| Java | O | O | O | O | O | O | ✅ |
+| JavaScript | O | O | O | O | O | O | ✅ |
+| Kotlin | O | O | O | O | X | O | ✅ |
+| Lua | O | O | O | O | O | O | |
+| PHP | O | O | O | O | X | X | ✅ |
+| Python | O | O | O | O | O | O | ✅ |
+| Ruby | O | O | X | O | X | X | ✅ |
+| Rust | O | O | O | O | O | O | |
+| TypeScript | O | O | O | O | O | O | ✅ |
+| YAML | O | O | X | X | X | X | ✅ |
+
+> Bash note: `goto_definition`, `find_references`, `prepare_rename`, and `rename` are supported only within the same file.
+>
+> CSS note: `symbols` is not supported — biome does not implement `textDocument/documentSymbol` for CSS files.
+>
+> PHP note: `prepare_rename` and `rename` are not supported — intelephense does not support rename for plain PHP functions.
+>
+> Ruby note: `goto_definition`, `prepare_rename`, and `rename` are not supported — ruby-lsp requires a full Ruby project (Gemfile) to index symbols for definition navigation, and does not support rename for method definitions in standalone files.
+
+### AST-Grep Tools
+
+| Tool | Description |
+|------|-------------|
+| **ast_grep_search** | AST-aware code pattern search (25 languages) |
+| **ast_grep_replace** | AST-aware code replacement |
+
+### `goto_definition`
+
+```bash
+oh-my-lsp goto_definition <file-path> <line> <character> [--timeout=60000] [--base-path <path>] [--verbose]
+```
+
+- `line`: 0-based (required)
+- `character`: 0-based (required)
+
+### `find_references`
+
+```bash
+oh-my-lsp find_references <file-path> <line> <character> [--timeout=60000] [--base-path <path>] [--verbose] [--no-include-declaration]
+```
+
+- Includes declaration by default (`includeDeclaration=true`)
+- Excludes declaration when `--no-include-declaration` is used
+
+### `symbols`
+
+```bash
+oh-my-lsp symbols <file-path> [--scope document|workspace] [--query <query>] [--limit <n>] [--timeout=60000] [--base-path <path>] [--verbose]
+```
+
+- `--query` is required when `--scope workspace`
+
+### `diagnostics`
+
+```bash
+oh-my-lsp diagnostics <file-path> [--severity error|warning|information|hint|all] [--timeout=60000] [--base-path <path>] [--verbose]
+```
+
+### `prepare_rename`
+
+```bash
+oh-my-lsp prepare_rename <file-path> <line> <character> [--timeout=60000] [--base-path <path>] [--verbose]
+```
+
+### `rename`
+
+```bash
+oh-my-lsp rename <file-path> <new-name> <line> <character> [--timeout=60000] [--base-path <path>] [--verbose]
+```
+
+- If `--base-path` is set, that path is used as the LSP server workspace root (`cwd/root`) instead of auto-detecting the workspace root.
+
+### `ast_grep_search`
+
+```bash
+oh-my-lsp ast_grep_search <lang> <pattern> [--paths <path1> <path2> ...] [--globs <glob1> <glob2> ...] [--context <n>] [--timeout=300000] [--verbose]
+```
+
+- Meta variable examples: `$VAR` (single node), `$$$` (multiple nodes)
+- Pattern should be a complete AST node
+- Supports 25 languages (`bash`, `c`, `cpp`, `csharp`, `css`, `elixir`, `go`, `haskell`, `html`, `java`, `javascript`, `json`, `kotlin`, `lua`, `nix`, `php`, `python`, `ruby`, `rust`, `scala`, `solidity`, `swift`, `typescript`, `tsx`, `yaml`)
+
+### `ast_grep_replace`
+
+```bash
+oh-my-lsp ast_grep_replace <lang> <pattern> <rewrite> [--paths <path1> <path2> ...] [--globs <glob1> <glob2> ...] [--no-dry-run] [--timeout=300000] [--verbose]
+```
+
+- Dry-run preview is default
+- Use `--no-dry-run` to apply changes to files
+
+## License
+
+MIT License - see LICENSE file for details