greptile 3.2.3 → 3.3.1

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to the Greptile CLI.
 
+## Unreleased
+
+## 3.3.1 - 2026-07-29
+
+### Fixed
+
+- CLI reviews and rendered results now work when Git is configured with custom
+  diff path prefixes or no prefixes.
+
+## 3.3.0 - 2026-07-28
+
+### Added
+
+- `greptile skills` installs two skills for AI coding agents: `greptile-cli`
+  (commands, JSON output, exit codes) and `greploop` (review, fix, review again
+  until it comes back clean). They are written to `.agents/skills/`, plus
+  `.claude/skills/` and `.codex/skills/` when those agents are set up.
+- Onboarding offers to install them, for this repository or for every project.
+- Privacy-aware usage telemetry sends product events through Greptile's
+  first-party endpoint without including code, repository names, paths, or
+  review content. Interactive users choose whether to link usage to their
+  account, while automated runs remain anonymous until a choice is recorded.
+
+### Changed
+
+- The Important Files Changed section is collapsed by default in new review
+  settings, while explicit repository, namespace, and personal settings still
+  take precedence.
+- Removed retired steps from the CLI onboarding sequence so it stays aligned
+  with the current web onboarding flow.
+
 ## 3.2.3 - 2026-07-17
 
 ### Fixed

package/README.md

@@ -9,6 +9,7 @@ Greptile code review in your terminal. Runs the same review Greptile posts on yo
 - [Authentication](#authentication)
 - [Sensitive files](#sensitive-files)
 - [Settings](#settings)
+- [Agent skills](#agent-skills)
 - [Diagrams](#diagrams)
 - [Fix in Claude Code](#fix-in-claude-code)
 - [Updating](#updating)
@@ -55,6 +56,7 @@ Comments appear in the terminal as they come in.
 | `greptile logout`           | Remove stored credentials.                                           |
 | `greptile whoami`           | Show who you are signed in as and your organizations.                |
 | `greptile settings`         | Manage CLI preferences, repositories, review settings, and team.     |
+| `greptile skills`           | Install the Greptile agent skills for your AI coding agents.         |
 | `greptile fix`              | Set up or remove Fix in Claude Code on macOS.                        |
 | `greptile update`           | Update the CLI to the latest version.                                |
 
@@ -210,6 +212,35 @@ A flag passed on the command line always wins over a saved setting for that run.
 
 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.
 
+## Agent skills
+
+Skills are instructions AI coding agents read. The CLI bundles two:
+
+| Skill          | What it covers                                                                          |
+| -------------- | --------------------------------------------------------------------------------------- |
+| `greptile-cli` | How to run the CLI: commands, JSON output shapes, exit codes.                           |
+| `greploop`     | Reviewing a branch, fixing the findings, and reviewing again until it comes back clean. |
+
+`greptile onboard` offers to install them. You can also do it anytime:
+
+```sh
+greptile skills list                  # what ships with this CLI
+greptile skills install               # asks where, if you're at a terminal
+greptile skills install --global      # all your projects, no prompt
+greptile skills install greploop      # just one
+greptile skills install --force       # replace installed copies
+```
+
+Skills are written to `.agents/skills/<name>/`, which Codex, Cursor, Gemini CLI, Copilot and other
+tools following the [Agent Skills](https://agentskills.io) standard read, plus `.claude/skills/`
+and `.codex/skills/` when those agents are set up in the same place.
+
+An installed skill is left alone unless you pass `--force`, so local edits are kept. A skill left
+incomplete by a failed write is repaired on the next run.
+
+They are compiled into the CLI, so they describe the version you have installed. Upgrade the CLI
+and re-run with `--force` to update them.
+
 ## Diagrams
 
 When a review summary includes a Mermaid diagram, greptile renders it inline in kitty and Ghostty, and links an SVG file in other terminals. The first time a diagram renders, greptile downloads a small renderer ([mmdr](https://github.com/1jehuang/mermaid-rs-renderer)) into `~/.cache/greptile/`. Set `GREPTILE_NO_AUTO_INSTALL=1` to skip the download.
@@ -257,6 +288,7 @@ greptile review [-b BRANCH] [--layout comments|diff | --diff] [--resume] [--incl
 greptile review show [ID]   # same output flags as review
 greptile review status [--commit REF] [--json | --text | --agent]
 greptile settings list | get KEY | set KEY VALUE | unset KEY | path
+greptile skills list [--json] | install [NAME...] [-g] [-f] [--json]
 greptile fix install | status [--json] | uninstall [--remove-mappings]
 greptile update
 ```