/lgtm

Name

lgtm

Description

Launch lgtm TUI to review a markdown file with line-by-line commenting

Allowed Tools

Bash(bun run *), Bash(bunx *), Bash(tmux *), Read

argument-hint

<file-path> [--stdin]

Launch lgtm to review the specified markdown file or piped content.

## Usage
/lgtm path/to/plan.md          # Opens TUI for review (auto-spawns in tmux pane)
/lgtm @CLAUDE.md               # @ prefix is stripped automatically
/lgtm --stdin                  # Review content piped from stdin

## What it does
Opens an interactive TUI for reviewing markdown documents with:
- Line-by-line navigation (j/k)
- Comment types: Blocker, Concern, Question, Suggestion, Praise, Acknowledge
- Syntax highlighting for code blocks
- Export to markdown (E) or clipboard (y)
- Summary view (v)

## Instructions

When this skill is invoked, follow these steps:

1. **Parse arguments**: Extract the file path from `$ARGUMENTS`. If it starts with `@`, strip that prefix. Ignore `--tmux` if present (it's automatic).
2. **Resolve path**: Convert the file path to an absolute path if it isn't already.
3. **Read the file**: Use the Read tool to load the full file content into context. This is essential so you can correlate the user's line-level comments with actual file content.
4. **Create export path**: Generate `/tmp/lgtm-export-{basename-without-extension}.md`
5. **Run the TUI**: Check if `${CLAUDE_PLUGIN_ROOT}/node_modules` exists to determine the run command. The `--export-on-quit` flag automatically enables tmux mode and waits for the user to quit.
   - If `${CLAUDE_PLUGIN_ROOT}/node_modules` exists (local dev):
     ```bash
     bun run ${CLAUDE_PLUGIN_ROOT}/src/cli.ts "<resolved-file-path>" --export-on-quit "<export-path>"
     ```
   - If `node_modules` does not exist (marketplace install):
     ```bash
     bunx @hapticdata/lgtm "<resolved-file-path>" --export-on-quit "<export-path>"
     ```
6. **Read the export**: After the command returns (user has quit the TUI), use the Read tool to read the export file.
7. **Respond in review mode**: This is a collaborative review workflow. After reading the export:
   - Correlate each comment with the corresponding line(s) from the original file content you read in step 3.
   - Summarize the user's feedback, grouping by comment type (Blockers, Concerns, Questions, Suggestions, Praise).
   - Proactively address blockers and concerns first — propose concrete code or content changes to resolve them.
   - Answer any questions the user raised.
   - Acknowledge suggestions and praise.
   - Offer to iterate on the file by applying the proposed changes.