more tweaks

README.md

@@ -0,0 +1,66 @@
+# forge.nvim
+
+**Forge-agnostic git workflow for Neovim**
+
+PR, issue, and CI workflows across GitHub, GitLab, and more — without leaving
+your editor.
+
+## Features
+
+- Forge detection from git remote (GitHub via `gh`, GitLab via `glab`,
+  Codeberg/Gitea/Forgejo via `tea`)
+- PR lifecycle: list, create, checkout, review, merge, approve, close/reopen,
+  draft toggle
+- Issue management: list, browse, close/reopen
+- CI/CD: view runs, stream logs, filter by status
+- PR compose buffer with diff stat, template discovery, and syntax highlighting
+- Code review via [diffs.nvim](https://github.com/barrettruth/diffs.nvim)
+  unified/split diff with quickfix navigation
+- Commit browsing with checkout, diff review, and URL yanking
+- Branch browsing with diff review and remote links
+- Worktree creation from PRs
+- File/line permalink generation (commit and branch URLs)
+- [fzf-lua](https://github.com/ibhagwan/fzf-lua) pickers with contextual
+  keybinds throughout
+
+## Dependencies
+
+- Neovim 0.10.0+
+- [fzf-lua](https://github.com/ibhagwan/fzf-lua)
+- At least one forge CLI:
+  - [`gh`](https://cli.github.com/) for GitHub
+  - [`glab`](https://gitlab.com/gitlab-org/cli) for GitLab
+  - [`tea`](https://gitea.com/gitea/tea) for Codeberg/Gitea/Forgejo
+- [vim-fugitive](https://github.com/tpope/vim-fugitive) (optional, for fugitive
+  keymaps)
+- [diffs.nvim](https://github.com/barrettruth/diffs.nvim) (optional, for review
+  mode)
+
+## Installation
+
+Install with your package manager of choice or via
+[luarocks](https://luarocks.org/modules/barrettruth/forge.nvim):
+
+```
+luarocks install forge.nvim
+```
+
+## Documentation
+
+```vim
+:help forge.nvim
+```
+
+## FAQ
+
+**Q: How do I create a PR?**
+
+Press `<c-g>` to open the forge picker, select "Pull Requests", then `<ctrl-a>`
+to create. Or from a fugitive buffer: `cpr` (create), `cpd` (draft), `cpf`
+(instant), `cpw` (web).
+
+**Q: Does forge.nvim support review diffs?**
+
+Yes, with [diffs.nvim](https://github.com/barrettruth/diffs.nvim) installed.
+Select a PR and press `<ctrl-d>` to enter review mode with unified diff. Press
+`s` to toggle split/unified view. Navigate files with `]q`/`[q`.