Internator

Internator is a Ruby-based CLI tool that automates iterative pull request improvements using OpenCode. It cycles through objectives, makes incremental changes, automatically commits and pushes each update, and optionally waits between iterations.

Requirements

• Ruby (>= 2.5).
• opencode CLI installed.

Installation

gem install internator

Usage

Create your new empty branch and run the internator command:

internator "<PR Objectives>" [delay_mins] [parent_branch]

• <PR Objectives>: Description of what the pull request should achieve.
• [delay_mins]: (Optional) Minutes to wait between commits (default: 0).
• [parent_branch]: (Optional) Branch name to diff against (default: detected repository default branch).

Example:

internator "Refactor authentication flow and add tests" 10

For more detailed usage tips, see the Usage Tips wiki page.

Configuration

Internator reads custom instructions from a YAML file at ~/.internator_config.yml. The file must define an instructions key whose value is the instruction text. For example:

# ~/.internator_config.yml
instructions: |
  1. Do not overuse code comments; if the method name says it all, comments are not necessary.
  2. Please treat files as if Vim were saving them with `set binary` and `set noeol`, i.e. do not add a final newline at the end of the file.

When present, Internator will use these instructions instead of the built-in defaults.

Contributing

Feel free to open issues or submit pull requests.

License

Internator is released under the MIT License. See the LICENSE file for details.