Plugins
Every review uses a plugin, and the plugin decides what the person sees and what the agent gets back. Five official plugins come with the app. The setup installs the two it recommends, and you install the others when your agents need them.
Which plugin to use
Section titled “Which plugin to use”| When your agent needs a person to… | Use | |
|---|---|---|
| Accept or reject a set of findings, tasks or proposed actions | List | Recommended |
| Answer questions before it goes on: choices, preferences, confirmations | Feedback | Recommended |
| Review the comments it wants to post on a pull or merge request | Code review | Optional |
| Choose between images or illustrations it generated, and mark what to change on them | Image review | Optional |
| Read a plan, spec or document it wrote, and ask for changes or explanations | Markdown review | Optional |
| Edit emails, choose calendar slots, or review designed pages, logos or 3D models | Sample plugins |
When nothing fits exactly, start with List. Almost any batch of proposed actions reads well as grouped items with a verdict each, and the setup installs it. When the decision needs a view of its own, build a plugin.
Installing and updating
Section titled “Installing and updating”Recommended plugins are the ones the setup installs. Optional plugins come with the app too, and you install them when you need them. Install either kind in Settings › Plugins, where the Install field lists the plugins not yet installed, or from the command line:
pinrail plugins install markdownA newer version of a plugin arrives with an app update. Settings › Plugins then shows Update on the plugin’s row, and nothing changes until you choose it. Any plugin can be removed. See Installing plugins.
How every plugin page is laid out
Section titled “How every plugin page is laid out”Each page answers the same questions, in the same order:
- What it is for, with the situations it suits.
- What you see: the view, and what you can do in it.
- Asking from your agent: instructions to paste into your agent’s instructions file, so it knows when and how to ask.
- What the agent sends and what comes back: the payload and the decision, with examples.