https://github.com/floatpane/loom
Beatiful and powerful editor for Git
https://github.com/floatpane/loom
Last synced: 18 days ago
JSON representation
Beatiful and powerful editor for Git
- Host: GitHub
- URL: https://github.com/floatpane/loom
- Owner: floatpane
- License: mit
- Created: 2026-07-07T15:48:23.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2026-07-16T06:19:31.000Z (24 days ago)
- Last Synced: 2026-07-16T08:11:28.446Z (24 days ago)
- Language: Go
- Homepage:
- Size: 148 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# loom
A beautiful Git commit and rebase editor for the terminal.
[](https://golang.org)
[](https://github.com/floatpane/loom/releases)
[](LICENSE)
loom is a lightweight TUI that replaces `GIT_EDITOR` for writing commit
messages and interactive rebasing. It provides syntax-highlighted commit
messages, conventional-commit autocomplete, co-author suggestions, a
scrollable diff view, and a floating suggestion popup styled after VSCode
and nvim-cmp.
## Features
- **Commit message editor** — syntax highlighting for conventional commits,
trailers (`Co-authored-by`, `Reviewed-by`, `Signed-off-by`, etc.), and
bullet points
- **Interactive rebase editor** — change actions (pick, reword, edit, squash,
fixup, drop), reorder commits, and expand inline diffs
- **Floating autocomplete** — VSCode/nvim-style suggestion popup at the
cursor position, powered by the [bubble-overlay](https://github.com/floatpane/bubble-overlay)
library
- **Conventional commit types** — `feat`, `fix`, `docs`, `refactor`, and
more, with descriptions
- **Trailer autocomplete** — suggests trailer names (`Co-authored-by:`,
`Reviewed-by:`, …) and person values from git history and a persistent
local store
- **Persistent people** — co-authors and reviewers are saved to
`~/.loom/people.json` and recalled across sessions
- **Diff view** — scrollable, syntax-highlighted diff with line numbers for
15+ languages
## Installation
### Homebrew
```bash
brew tap floatpane/loom
brew install loom
```
### Snap
```bash
sudo snap install loom
```
### Build from source
```bash
go install github.com/floatpane/loom@latest
```
### Download binary
Download the latest binary from the
[releases page](https://github.com/floatpane/loom/releases).
## Usage
Set loom as your Git editor:
```bash
git config --global core.editor "loom"
git config --global sequence.editor "loom"
```
Or use it ad-hoc:
```bash
GIT_EDITOR=loom git commit
GIT_EDITOR=loom git rebase -i HEAD~5
```
loom automatically detects whether the file is a `git-rebase-todo` or a
commit message and launches the appropriate interface.
### Rebase command
loom also includes a convenience rebase command that fetches and rebases
the current branch onto its upstream default branch:
```bash
loom rebase
```
This fetches the latest changes from the current branch's upstream remote
and rebases onto `upstream/` (or the current remote's
default branch if no upstream is configured).
To rebase a specific PR's branch without leaving your current branch:
```bash
loom rebase pr 123
```
This checks out PR #123's branch, rebases it onto its upstream, then
returns you to the branch you were on.
## Contributing
Pull requests are welcome. Please follow the
[PR template](.github/pull_request_template.md) format.
## License
[MIT](LICENSE)