[Feature Request] Start the Guided Review and the agent review automatically, with saved default options

Open
  • Is something wrong?
#2,666 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
developer-experience

Research direction

Start by locating the plannotator review CLI entry point and the code that opens a review session, then trace how Guided Review and agent review options reach their UI controls. The issue does not name files or tests, so map the current option and session flows before estimating the change. Done means saved defaults and session flags start or preselect both jobs as described across the listed review targets and agent hosts.

Written by the indexing model from the issue text.

Description

Problem

Almost every time I run plannotator review, the first thing I do in the browser is click two buttons: one to
generate the Guided Review and one to start the agent review. Each time I also pick the same options for both
(provider, effort, and so on). Both jobs take a while, so I end up waiting for them after the page is already open.
Version 0.28.49 has no flag or config.json setting to start them automatically, or to save the options I always
choose.

Proposal

  1. A saved default in config.json for each job: whether it starts on its own, and the options the UI asks for
    today (provider, model, effort, and the rest). Something like: 
    "reviewDefaults": {
  "guide": {
    "autoStart": true,
    "provider": "claude",
    "effort": "high"
  },
  "agentReview": {
    "autoStart": true,
    "provider": "codex",
    "effort": "medium"
  }
}
    The UI would show these as the preselected choices, and could offer to save the current choice as the default.
  2. CLI flags that apply to the current session only, like --base and --diff-type: 
    plannotator review --guide --agent-review
plannotator review --no-guide --no-agent-review
    The job options could have session flags too, but the saved defaults matter most.

Expected behaviour

  • With autoStart on, the job starts as soon as the review session opens, before the browser page has loaded, with
    the saved options. The page shows it as already running, exactly as if its button had been clicked.
  • With autoStart off, nothing starts by itself, but the saved options are still preselected when the button is
    clicked.
  • It works the same with --base, --diff-type, a PR URL and a directory target.
  • When an agent host such as the Claude Code plugin opens the review, it can pass the same flags.

Why

This saves two clicks and the same option choices on every review. It also means the guide and the agent findings
are often ready by the time I start reading the diff, instead of me waiting for them afterwards.

Related

  • #982: headless sessions where agents comment before the UI is shown (closed). It is about an agent posting
    annotations, not about starting Plannotator's own guide and agent review jobs.
  • #1265: extra instructions for the Guided Review.
Dominant language
TypeScript
Stars
8.7k
Forks
649
Avg merge
8h 25m
Merged PRs (30d)
761

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from backnotprop/plannotator

All issues in backnotprop/plannotator

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.