{"id":31736115,"url":"https://github.com/3ZsForInsomnia/revman.nvim","last_synced_at":"2025-10-09T09:07:00.458Z","repository":{"id":297849050,"uuid":"997699756","full_name":"3ZsForInsomnia/revman.nvim","owner":"3ZsForInsomnia","description":"An easier way to track multiple PRs that you are reviewing","archived":false,"fork":false,"pushed_at":"2025-09-19T23:18:53.000Z","size":143,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-20T00:58:31.405Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/3ZsForInsomnia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-07T01:58:03.000Z","updated_at":"2025-09-19T23:18:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"bd209bb5-9193-4fc0-97a7-0e89ec5f4ebf","html_url":"https://github.com/3ZsForInsomnia/revman.nvim","commit_stats":null,"previous_names":["3zsforinsomnia/revman.nvim"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/3ZsForInsomnia/revman.nvim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ZsForInsomnia%2Frevman.nvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ZsForInsomnia%2Frevman.nvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ZsForInsomnia%2Frevman.nvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ZsForInsomnia%2Frevman.nvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/3ZsForInsomnia","download_url":"https://codeload.github.com/3ZsForInsomnia/revman.nvim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ZsForInsomnia%2Frevman.nvim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001179,"owners_count":26083021,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-09T09:01:33.114Z","updated_at":"2025-10-09T09:07:00.453Z","avatar_url":"https://github.com/3ZsForInsomnia.png","language":"Lua","readme":"# revman.nvim\n\n**revman.nvim** is a Neovim plugin that streamlines your GitHub pull request review workflow—especially when paired with [Octo.nvim](https://github.com/pwntester/octo.nvim). Its primary purpose is to help you track and manage PRs that are waiting for your review, across multiple repositories, all from inside Neovim.\n\nThe core workflow is simple:\n- **Add a PR** to your local database.\n- **Browse PRs** (especially those \"waiting for review\") using Telescope.\n- **Open the PR in Octo.nvim** for a full-featured review.\n- **Mark the PR as \"waiting for changes\"** when you’re done.\n- **Optionally add a note** for future references outside of comments.\n- **Let revman.nvim sync PRs in the background** so your review queue is always up to date.\n\nAnd it also includes features like analytics and advanced filtering - handy extras to help you stay organized and productive!\n\n---\n\n## Typical Workflow\n\n1. **Add your repo:**  \n   Use `:RevmanAddRepo` in your project directory to register the current repo.\n\n2. **Sync PRs:**  \n   Run `:RevmanSyncAllPRs` to fetch PRs from GitHub into a local SQLite database.\n\n3. **Browse \u0026 Filter:**  \n   Use Telescope-powered commands like `:RevmanListOpenPRs` or `:RevmanListPRs` to find and select PRs.\n\n4. **Review \u0026 Take Notes:**  \n   Open a PR for review with `:RevmanReviewPR` (opens in Octo.nvim if installed).  \n   Add or edit notes with `:RevmanAddNote`.\n\n5. **Track Status:**  \n   Update PR review status with `:RevmanSetStatus`.\n\n6. **Stay Up to Date:**  \n   Enable background sync with `:RevmanEnableBackgroundSync` to keep your PR list fresh.\n\n---\n\n## Installation\n\nRequirements:\n- Neovim 0.7+\n- [kkharji/sqlite.lua](https://github.com/kkharji/sqlite.lua)\n- [GitHub CLI (`gh`)](https://cli.github.com/) (must be installed and authenticated)\n- [pwntester/octo.nvim](https://github.com/pwntester/octo.nvim) (optional, but required for PR review UI and strongly suggested)\n\nA Picker is strongly recommended. Supported pickers:\n- [Snacks Picker](https://github.com/folke/snacks.nvim/blob/main/docs/picker.md)\n- [nvim-telescope/telescope.nvim](https://github.com/nvim-telescope/telescope.nvim)\n\nExample (Lazy.nvim):\n\n```lua\n{\n  \"3ZsForInsomnia/revman.nvim\",\n  dependencies = {\n    \"kkharji/sqlite.lua\",\n    \"pwntester/octo.nvim\",\n  },\n  config = true,\n}\n```\n\n---\n\n## Setup\n\nCall `require(\"revman\").setup()` in your config.  \nExample:\n\n```lua\nrequire(\"revman\").setup({\n  database_path = vim.fn.stdpath(\"state\") .. \"/revman/revman.db\",\n  data_retention_days = 30, -- days to keep PRs (0 = keep forever)\n  background_sync_frequency = 15, -- minutes between background syncs (0 = disable)\n  picker = \"vimSelect\", -- \"vimSelect\", \"telescope\", or \"snacks\"\n  log_level = \"warn\", -- \"info\", \"warn\", or \"error\"\n})\n```\n\n---\n\n## Main Commands\n\n| Command                        | Description                                |\n|--------------------------------|--------------------------------------------|\n| `:RevmanAddRepo`               | Add current repo to tracking               |\n| `:RevmanSyncAllPRs`            | Sync all PRs for the current repo          |\n| `:RevmanListPRs`               | List all PRs (Telescope picker)            |\n| `:RevmanListOpenPRs`           | List open PRs (Telescope picker)           |\n| `:RevmanListMergedPRs`         | List merged PRs (Telescope picker)         |\n| `:RevmanReviewPR`              | Mark PR as reviewed and open for review    |\n| `:RevmanSetStatus`             | Set review status for a PR                 |\n| `:RevmanAddNote`               | Add or edit a note for a PR                |\n| `:RevmanShowNotes`             | Browse PR notes (Telescope picker)         |\n| `:RevmanEnableBackgroundSync`  | Enable background PR sync                  |\n| `:RevmanDisableBackgroundSync` | Disable background PR sync                 |\n\n---\n\nFor full details and advanced usage, see `:help revman`.\n\n## Roadmap\n\n- [ ] Add images and gifs of usage to the README\n- [ ] Simplifying and documenting exposed API\n- [ ] Allowing support for other pickers than Telescope\n","funding_links":[],"categories":["Git"],"sub_categories":["GitHub"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3ZsForInsomnia%2Frevman.nvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F3ZsForInsomnia%2Frevman.nvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3ZsForInsomnia%2Frevman.nvim/lists"}