tuicr（tuicr 搜索）

tuicr - TUI Change Reviewer

Launch the tuicr TUI tool in a tmux split pane to interactively review local git changes.

Usage

/tuicr [directory]

Or simply mention wanting to review changes with tuicr.

How It Works

Since coding agents cannot run interactive TUI applications directly, this skill uses a tmux workaround:

1. Detects if the current agent session is running inside tmux
2. If yes: Creates a split pane with tuicr running in it
3. If no: Provides instructions to restart the agent inside tmux

Determining the Directory

Important: You must determine the correct git repository directory based on context.

Consider:

• The user's current working directory
• Any repository they've been working in during the session
• Explicit directory mentioned in their request
• The git status output if available

Common patterns:

• "review my changes" -> use current working directory
• "review changes in myproject" -> find that repo path
• After editing files -> use the directory of those files

Workflow

1. Determine target directory:

- Check current working directory - Consider recent file operations - Ask user if ambiguous

1. Run the wrapper script with a 10-minute timeout: <skill-directory>/tuicr-wrapper.sh [directory] IMPORTANT: Always set timeout: 600000 (10 minutes) on the Bash tool call. The script waits for tuicr to exit, and without the extended timeout the agent may background the command after 2 minutes.
2. Handle the result:

- If successful: tuicr opens in a split pane and blocks until user exits - If not in tmux: relay the instructions to the user - If not a git repo: inform user and ask for correct path

1. Process instructions from tuicr output: The script output may contain instructions between markers: === TUICR INSTRUCTIONS === <instructions here> === END TUICR INSTRUCTIONS === If instructions are present: Parse and execute them. These are typically code changes or actions the user approved during the review. If no instructions in output: The script will say "No instructions exported" or mention clipboard. Tell the user: "No instructions were exported from tuicr. If you exported to clipboard, paste the instructions here and I'll execute them."

Configuration

The wrapper script supports environment variables:

Example with custom settings:

TUICR_PANE_SIZE=70 TUICR_PANE_POSITION=bottom <skill-directory>/tuicr-wrapper.sh /path/to/repo

Example Invocations

User says: "review my changes" -> Run tuicr-wrapper.sh with current working directory

User says: "let me review the changes in myproject" -> Find myproject path based on context -> Run tuicr-wrapper.sh with that path

User says: "/tuicr ~/projects/myapp" -> Run tuicr-wrapper.sh with ~/projects/myapp

Tmux Tips (relay to user if needed)

• Switch between panes: Ctrl-b then arrow keys
• Close tuicr: Press q in tuicr (pane closes automatically)
• Resize panes: Ctrl-b then Ctrl-arrow
• Zoom current pane: Ctrl-b then z (toggle)

Error Handling

When NOT to use

• When user just wants git diff output (use git directly)
• When reviewing remote/PR changes (use gh CLI or web)
• When user explicitly asks for non-interactive review