Skip to content

feat(skill): add Claude Code skill for interactive review#143

Merged
agavra merged 1 commit intoagavra:mainfrom
keymon:feature/claude-code-skill
Jan 24, 2026
Merged

feat(skill): add Claude Code skill for interactive review#143
agavra merged 1 commit intoagavra:mainfrom
keymon:feature/claude-code-skill

Conversation

@keymon
Copy link
Copy Markdown
Contributor

@keymon keymon commented Jan 24, 2026

Adds a Claude Code skill that allows running tuicr from within Claude sessions via tmux integration. This complements PR #142 (--stdout flag) but works independently using clipboard mode.

What this adds

  • .claude/skill/ - Claude Code skill that:

    • Detects if Claude is running in tmux
    • Opens tuicr in a split pane for interactive review
    • Waits for review completion
    • Captures output (via --stdout if available) or prompts user to paste from clipboard
  • README section documenting how to install the skill

How it works

The skill uses a tmux-based workaround since Claude Code can't run interactive TUI apps directly. When invoked:

  1. Opens tuicr in a tmux split pane above the Claude pane
  2. User reviews changes and exits tuicr
  3. If --stdout is supported (PR feat(cli): add --stdout flag to output export to stdout #142), output is captured automatically
  4. Otherwise, user pastes clipboard content back to Claude

Installation

# Copy to local skills
cp -r /path/to/tuicr/.claude/skill ~/.claude/skills/tuicr

# Or point Claude to this repo
claude skill add /path/to/tuicr/.claude/skill

This is a great tool for AI-assisted development - the "let the agent loose, then review like a PR" workflow is exactly what's been missing.

🤖 Generated with Claude Code

Adds a Claude Code skill that launches tuicr in a tmux split pane,
enabling interactive code review from within Claude sessions. Comments
are captured and fed back to Claude automatically.

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@keymon keymon marked this pull request as ready for review January 24, 2026 01:52
@keymon
Copy link
Copy Markdown
Contributor Author

keymon commented Jan 24, 2026

Future consideration: MCP alternative

This skill + wrapper script approach works, but a cleaner long-term solution could be implementing MCP (Model Context Protocol) support directly in tuicr:

tuicr --mcp          # Run as MCP server
tuicr --tmux [dir]   # Spawn self in tmux pane (replaces wrapper script)

Benefits:

  • Single binary, no shell scripts or skill files
  • Claude discovers tools automatically via MCP
  • Better error handling in Rust vs bash
  • Cleaner distribution (brew install tuicr gives you everything)

The MCP review_changes(directory) tool would internally spawn tuicr --stdout in a tmux split pane and return the review output directly to Claude.

This is a bigger change, but would make tuicr a fully self-contained "Claude Code companion" tool. Happy to explore this if there's interest.

@agavra
Copy link
Copy Markdown
Owner

agavra commented Jan 24, 2026

@keymon This is super cool! I won't be able to look at this until later tomorrow but I'll definitely review it and play around with it then.

Copy link
Copy Markdown
Owner

@agavra agavra left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tried this out locally as well as reviewed the PR (after rebasing on your --stdout patch) and it works brilliantly. Very cool! Thanks @keymon

@agavra agavra merged commit 12061e0 into agavra:main Jan 24, 2026
4 checks passed
@keymon
Copy link
Copy Markdown
Contributor Author

keymon commented Jan 24, 2026 via email

@agavra
Copy link
Copy Markdown
Owner

agavra commented Jan 24, 2026

My personal preference is for the skill, I'll use it for a bit and see if it feels limited. It seems like it's more well contained than a full MCP server (which also complicates tuicr for people that use it in "vanilla" mode off to the side).

@keymon
Copy link
Copy Markdown
Contributor Author

keymon commented Jan 24, 2026 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants