Skip to content
jcrussellPublic
forked from forge-ext/forge

About

Tiling and Window Manager for Gnome-Shell maintained by Claude

Topics

Resources

Contributing

Stars

24 stars

Watchers

2 watching

Forks

 
 

Latest commit

 

History

1,238 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Forge (maintained by Claude)

CI codecov

Note

Maintained by Claude, used daily by @jcrussell. This fork ships under its own UUID and versioning for now; the hope is to merge it back upstream (discussion). PRs welcome.

i3/sway-style tiling for GNOME Shell 45–51, on X11 and Wayland. A fork of Forge.

Forge tiling a GNOME desktop

  • Tree-based tiling: nested horizontal/vertical splits, stacked and tabbed containers, monocle. See layouts.
  • Vim-style keyboard control with an on-screen cheatsheet. See keybindings.
  • Drag-and-drop tiling, floating windows and per-app window rules.
  • Per-monitor, per-workspace trees. See multi-monitor.
  • Settings and keybindings as portable JSON.

Install

Download forge@jcrussell.github.io.zip and SHA256SUMS from the latest release, then:

sha256sum -c SHA256SUMS    # optional: verify the download
gh attestation verify forge@jcrussell.github.io.zip --repo jcrussell/forge   # optional: verify provenance
gnome-extensions install --force forge@jcrussell.github.io.zip
# log out and back in so GNOME Shell sees the extension, then:
gnome-extensions enable forge@jcrussell.github.io

enable reports "does not exist" until the shell has rescanned, hence the log-out in between. To build from source instead, see CONTRIBUTING.md.

Upgrading from forge@jmmaranan.com

Upstream Forge and this fork before v2026.11.0 use the UUID forge@jmmaranan.com. Remove that copy first, or both tile at once:

gnome-extensions uninstall forge@jmmaranan.com

For a distro-packaged copy, uninstall the package (or gnome-extensions disable forge@jmmaranan.com). Settings and ~/.config/forge carry over.

Use

Press Super+Shift+/ for the cheatsheet of your current shortcuts and Super+. for preferences. Everything else is in the user guide.

Contributing

See CONTRIBUTING.md.

Credits

  • @jmmaranan and the upstream contributors, who created Forge
  • Michael Stapelberg and contributors for i3
  • System76 and contributors for pop-shell
  • ReworkCSS and contributors for css-parse/css-stringify

About

Tiling and Window Manager for Gnome-Shell maintained by Claude

Topics

Resources

Contributing

Stars

24 stars

Watchers

2 watching

Forks

Releases

Contributors

Languages