Sight

TUI for closing the loop on AI-generated code changes.

Installation

gem install sight

Usage

Stage some changes (or have unstaged changes), then run:

sight

Keybindings

Key	Action
`j`	Next hunk
`k`	Previous hunk
`n`	Next file
`p`	Previous file
`Ctrl-F` / `Ctrl-B`	Scroll full page down / up
`Ctrl-D` / `Ctrl-U`	Scroll half page down / up
`?`	Toggle help
`c`	Comment on hunk
`q` / `Esc`	Quit

Agent Integration

Install a hook so annotations are automatically fed as context in your next message:

Claude Code (~/.config/claude/settings.json):

sight install-hook claude

When you quit sight after annotating, the next message you send will include your annotations.

The hook runs on every prompt but is a no-op when there's no pending review — it produces no output and adds nothing to the agent's context.

To remove:

sight uninstall-hook claude

Cursor — Create a rule in .cursor/rules/sight.mdc:

---
description: When the user asks to review their sight annotations or code review comments
alwaysApply: false
---

Read `.git/sight/pending-review`, address the annotations, then delete the file.

Development

bin/setup
rake test
bundle exec standardrb

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/arzezak/sight. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Sight project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

sight

Runtime