greptile 3.1.0 → 3.2.0

package/CHANGELOG.md

@@ -2,6 +2,40 @@
 
 All notable changes to the Greptile CLI.
 
+## 3.2.0 - 2026-07-10
+
+### Added
+
+- Interactive onboarding with `greptile onboard`: create or reconfigure an
+  organization, connect GitHub or GitLab, enable repositories, configure review
+  behavior, invite teammates, and resume an interrupted setup.
+- Interactive review settings and member management from `greptile settings`.
+- Self-hosted deployment targeting, trust controls, and OAuth discovery.
+- Custom review instructions with `greptile review --instructions`.
+
+### Changed
+
+- `greptile review` now guides users into onboarding when their account has no
+  organization membership or onboarding is incomplete.
+- Removed Azure DevOps support from the CLI.
+
+### Fixed
+
+- Authentication requests consistently stay on the selected deployment,
+  including staging and self-hosted environments.
+- Internal review failures are redacted instead of exposing server details.
+- Onboarding handles existing organizations, provider connection retries,
+  invitations, and reconfiguration more reliably.
+
+## 3.1.1 - 2026-06-14
+
+### Changed
+
+- Renamed the `greptile config` command to `greptile settings`, and saved
+  preferences now live in `settings.json` instead of `config.json`. An existing
+  `config.json` is moved to the new name automatically the first time you run
+  the CLI, so saved settings carry over.
+
 ## 3.1.0 - 2026-06-11
 
 ### Added

package/README.md

@@ -8,7 +8,7 @@ Greptile code review in your terminal. Runs the same review Greptile posts on yo
 - [Reviewing](#reviewing)
 - [Authentication](#authentication)
 - [Sensitive files](#sensitive-files)
-- [Configuration](#configuration)
+- [Settings](#settings)
 - [Diagrams](#diagrams)
 - [Updating](#updating)
 - [Reference](#reference)
@@ -32,6 +32,7 @@ curl -fsSL https://raw.githubusercontent.com/greptileai/cli/main/install.sh | ba
 
 ```sh
 greptile login        # opens your browser to sign in
+greptile onboard      # creates or configures your Greptile organization
 cd path/to/your/repo
 greptile review       # reviews HEAD against the default branch
 ```
@@ -40,15 +41,17 @@ Comments appear in the terminal as they come in.
 
 ## Commands
 
-| Command                     | What it does                                                   |
-| --------------------------- | -------------------------------------------------------------- |
-| `greptile review`           | Review the current branch against its base.                    |
-| `greptile review show [ID]` | Reopen a previous review. Omit the ID to pick from a list.     |
-| `greptile login`            | Sign in through your browser, or with `--api-key`.             |
-| `greptile logout`           | Remove stored credentials.                                     |
-| `greptile whoami`           | Show who you are signed in as and your organizations.          |
-| `greptile config`           | Save default settings (`list`, `get`, `set`, `unset`, `path`). |
-| `greptile update`           | Update the CLI to the latest version.                          |
+| Command                     | What it does                                                         |
+| --------------------------- | -------------------------------------------------------------------- |
+| `greptile review`           | Review the current branch against its base.                          |
+| `greptile review show [ID]` | Reopen a previous review. Omit the ID to pick from a list.           |
+| `greptile review status`    | Report the most recent review status for a commit (HEAD by default). |
+| `greptile login`            | Sign in through your browser, or with `--api-key`.                   |
+| `greptile onboard`          | Create or reconfigure a Greptile organization interactively.         |
+| `greptile logout`           | Remove stored credentials.                                           |
+| `greptile whoami`           | Show who you are signed in as and your organizations.                |
+| `greptile settings`         | Save default settings (`list`, `get`, `set`, `unset`, `path`).       |
+| `greptile update`           | Update the CLI to the latest version.                                |
 
 Run any command with `--help` for its full flag list.
 
@@ -79,6 +82,33 @@ greptile review show          # pick from recent reviews
 greptile review show abc123   # open one by ID
 ```
 
+List recent reviews non-interactively (for scripts and agents):
+
+```sh
+greptile review show --json   # recent reviews, grouped by commit
+greptile review show --agent  # the same list as plain text
+```
+
+Check whether the current commit has been reviewed (for a pre-push hook):
+
+```sh
+greptile review status              # checks HEAD
+greptile review status --commit abc123
+greptile review status --json
+```
+
+`review status` exits `0` when the commit has a completed review, `3` while one
+is still running, `4`/`5` for a failed/cancelled review, and `1` when there is
+no review (or you're signed out). Example pre-push hook:
+
+```sh
+greptile review status; case $? in
+  0) ;;                                          # reviewed — allow push
+  3) echo "Greptile review still running"; exit 1 ;;
+  *) echo "Run 'greptile review' before pushing"; exit 1 ;;
+esac
+```
+
 ### Machine-readable output
 
 ```sh
@@ -89,10 +119,17 @@ greptile review --agent                # alias for --text, for AI agents
 
 Exit codes are stable for scripting; see [Reference](#reference).
 
+> ℹ️ **Note:** `greptile review show` with no ID now prints the recent-reviews
+> list when output is piped or `--json`/`--text`/`--agent` is set (previously it
+> required an interactive terminal). In an interactive terminal it still opens
+> the picker.
+
 ### Working in multiple organizations
 
 There is nothing to configure. Each repository belongs to one Greptile organization, and `greptile review` infers it from the repo's remote URL. As long as you're a member of that organization, the review runs against it. `greptile whoami` lists your organizations.
 
+If you work in a sandboxed environment that routes git through a proxy (for example, remotes shaped like `https://<proxy-host>/proxy/github.com/<owner>/<repo>`), the CLI unwraps the proxy prefix automatically so the review resolves against the real host.
+
 ## Authentication
 
 `greptile login` signs you in through your browser (OAuth) and stores a refreshable token at `~/.greptile/auth.json`. Tokens refresh automatically. If the browser can't reach the CLI on the same machine (SSH sessions, containers, remote/cloud dev environments) the browser shows a login code instead; paste it at the `Paste code here if prompted:` prompt to finish signing in.
@@ -141,15 +178,15 @@ greptile review --include .env --include config/db.pem
 > - A commit that **removes** a hard-coded secret is also held back, because the removed value still appears in the diff. Use `--include` to review that cleanup commit.
 > - A **rename** away from a sensitive name (say `.env` to `config.txt`) is held back too, based on the original path.
 
-## Configuration
+## Settings
 
 Save defaults instead of repeating flags:
 
 ```sh
-greptile config set review.layout diff    # always show findings beside the code
-greptile config set review.context 30   # more code around each finding
-greptile config list                    # every setting and where it comes from
-greptile config unset review.layout       # back to the default
+greptile settings set review.layout diff   # always show findings beside the code
+greptile settings set review.context 30    # more code around each finding
+greptile settings list                     # every setting and where it comes from
+greptile settings unset review.layout      # back to the default
 ```
 
 | Setting          | Values                                  | Matching flag                                          |
@@ -162,7 +199,7 @@ greptile config unset review.layout       # back to the default
 
 A flag passed on the command line always wins over a saved setting for that run.
 
-Settings live in `~/.config/greptile/config.json` (or `$XDG_CONFIG_HOME/greptile/config.json`); `greptile config path` prints the exact location. The file includes a `$schema` reference to a published JSON Schema, so editors can validate and autocomplete it if you edit it by hand.
+Settings live in `~/.config/greptile/settings.json` (or `$XDG_CONFIG_HOME/greptile/settings.json`); `greptile settings path` prints the exact location. The file includes a `$schema` reference to a published JSON Schema, so editors can validate and autocomplete it if you edit it by hand.
 
 ## Diagrams
 
@@ -185,7 +222,8 @@ greptile login [--api-key] | logout | whoami
 greptile review [-b BRANCH] [--layout comments|diff | --diff] [--resume] [--include PATH...]
                 [--json | --text | --agent] [--context LINES] [--width COLUMNS] [--no-color]
 greptile review show [ID]   # same output flags as review
-greptile config list | get KEY | set KEY VALUE | unset KEY | path
+greptile review status [--commit REF] [--json | --text | --agent]
+greptile settings list | get KEY | set KEY VALUE | unset KEY | path
 greptile update
 ```
 
@@ -205,15 +243,18 @@ greptile update
 
 | Code  | Meaning                                                                          |
 | ----- | -------------------------------------------------------------------------------- |
-| `0`   | Review finished.                                                                 |
-| `1`   | Review couldn't finish (sign-in expired, server error, repo not connected, ...). |
-| `2`   | Invalid invocation (not inside a git repo, unknown flag, ...).                   |
+| `0`   | Review finished, or (`review status`) the commit has a completed review.         |
+| `1`   | Couldn't finish, or (`review status`) no review exists / signed out / no origin. |
+| `2`   | Invalid invocation (not inside a git repo, unknown flag, unresolvable commit).   |
+| `3`   | `review status` only: a review for the commit is still running.                  |
+| `4`   | `review status` only: the most recent review failed.                             |
+| `5`   | `review status` only: the most recent review was cancelled.                      |
 | `130` | Interrupted with Ctrl-C.                                                         |
 
 ### Files
 
-| Path                             | Contents                                 |
-| -------------------------------- | ---------------------------------------- |
-| `~/.greptile/auth.json`          | Credentials (refreshed automatically).   |
-| `~/.config/greptile/config.json` | Saved settings (`greptile config path`). |
-| `~/.cache/greptile/`             | Downloaded diagram renderer.             |
+| Path                               | Contents                                   |
+| ---------------------------------- | ------------------------------------------ |
+| `~/.greptile/auth.json`            | Credentials (refreshed automatically).     |
+| `~/.config/greptile/settings.json` | Saved settings (`greptile settings path`). |
+| `~/.cache/greptile/`               | Downloaded diagram renderer.               |