---

FileBlade is gives you IDE-like sidebars in Omarchy:

• View, search, and manage files or their properties and contents
• Helpful and malleable UI showing Git status or other information
• Drag files and hold spacebar to get an intuitive quick-action wheel
• Keyboard- or mouse-first; designed to quickly use and sheathe to get it out of your way
• Extend FileBlade to show other information or interactions in your sidebars

Note

Hello there! I made this plugin mostly as an experiment using coding agents; I needed something like this to support other projects.

I think it's important to be transparent that I'm from a non-technical background; I rely fully on coding agents for the project, but I've done my best to do my due diligence for planning and design, and to ensure quality and security.

I welcome any and all feedback or critique!

Warning

FileBlade is in 0.1.0-beta meaning that it's still undergoing testing and changes. Please only install it if you're comfortable with testing and feedback until it is out of beta.

Multiple monitors is currently not supported in the beta (sorry!) but is planned for v0.1.0

This README is human-written. See here for more detailed agent-written docs.

Installation / Quick-start

Until FileBlade appears in the Omarchy marketplace, install it directly from GitHub. This installs the plugin and its bundled x86-64 Linux binary together; no Rust toolchain or separate binary download is needed. Requires Omarchy 4.0.2 or later. Other architectures need a compatible backend built separately.

1. Install and enable FileBlade:

   OMARCHY_SHELL_IPC_TIMEOUT=10s omarchy plugin add https://github.com/data-goblin/fileblade.git --enable

2. Restart the shell after installation finishes:

   omarchy restart shell

3. Add the contents of examples/fileblade-bindings.lua to your existing ~/.config/hypr/bindings.lua, then run hyprctl reload.

4. Press Super+B or Super+Shift+B to open a sidebar.

To remove FileBlade, remove its extensions first, then run:

omarchy plugin remove data-goblin.fileblade
omarchy restart shell

Your layout, settings, history and recoverable bins are retained. Remove the FileBlade bindings you added if you no longer want them.

FileBlade has a plugin system via extensions, which are separate Omarchy plugins. The example extensions add Skills, Memory, Hooks, and MCP views for agent files:

Note

I'm open to baking these plugins into FileBlade core (Rust), rather than having them as the Python extensions. I kept them separate because I wasn't sure if adding these in core was an appropriate design decision. If you have an opinion, happy to hear it.

OMARCHY_SHELL_IPC_TIMEOUT=10s omarchy plugin add https://github.com/data-goblin/fileblade-skills.git --yes --enable
OMARCHY_SHELL_IPC_TIMEOUT=10s omarchy plugin add https://github.com/data-goblin/fileblade-memory.git --yes --enable
OMARCHY_SHELL_IPC_TIMEOUT=10s omarchy plugin add https://github.com/data-goblin/fileblade-hooks.git --yes --enable
OMARCHY_SHELL_IPC_TIMEOUT=10s omarchy plugin add https://github.com/data-goblin/fileblade-mcp.git --yes --enable
omarchy restart shell

Click an extension to see it:

Agent Skills example

Agent Memory example

The fileblade CLI has a command fileblade extension template which you can use to quickly get a starter template btw! :)

More details below :)

---

FileBlade: An Omarchy Plugin

FileBlade is an IDE-style filesystem and extensible blade host for the Omarchy Quattro shell. It provides left and right edge blades that can stay docked as layer surfaces or become ordinary tiled Hyprland windows. Each blade contains movable, resizable, tabbed module slots, which you can extend with a plugin system.

FileBlade Repos

• FileBlade core
• Memory
• Skills
• MCP
• Hooks

Features

• Left and right sidebars that open on keyboard shortcuts
• Management and navigation like a normal hyprland window
• Dock and undock sidebars
• Rust CLI fileblade backend which agents can also use to control and configure FileBlade
• Configurable sections of each sidebar like in an IDE
  • The default layout shows the file tree and properties
  • Bundled Notes keeps multiple named plain-text notes in any slot
  • Optional companion plugins can add Skills, Memory, MCP, Hooks, and Git modules; they are separate installs and are not installed automatically
• Selection from the filetree is shared with other modules and agents
• QoL search functionality
  • zoxide-like directory change
  • fzf-like search and deep search
  • Search syntax like -exclude "exact" and type:
  • Support for regex if you're a masochist :)
• QoL file management functionality
  • Color folders and files and adjust how colors appear
  • Undo/Redo, Cut/Copy/Paste, etc.
  • Recents, home, and trash

Example of the selection wheel:

...and a lot more that I'm probably forgetting :)

Click a feature to see it:

FileBlade filetree

Right-click actions and folder colours

Searching filetree

Quick nav (like zoxide)

How it changes your Omarchy installation

Here's a concise list of what happens when you install FileBlade:

Keybindings

FileBlade never writes to your Hyprland config. The binds below are the ones you add to ~/.config/hypr/bindings.lua (the block is in ARCHITECTURE.md under "Focus and keybindings"); each asks FileBlade first with a short timeout and falls back to the plain dispatcher, so nothing breaks when the shell is down.

• Super + B and Super + Shift + B open/close the left/right blades, respectively
• Super + W closes the focused sidebar, or a regular Hyprland window when no sidebar has focus
• Super + Arrows, Super + Shift + Arrows, and Super + T are also blade-aware: they focus, swap, and dock/undock a sidebar when one has focus, and otherwise behave like normal
• Super + Minus / Super + Equals resize the focused sidebar instead of the window when a sidebar has focus
• Super + Z opens the zoxide-like quick nav

Windows and focus; interaction with Hyprland

• Docked sidebars reserve their strip of the screen, so your tiled windows shift to make room
• While a sidebar has keyboard focus, the active border on your other windows is dimmed like hyprland does

Trash and soft deletes

• Trashed files go to ~/.local/share/Trash, so they show up in other file mgrs
• Trash is emptied automatically after 7 days by default; change it in settings
• Things you manage through plugins (skills, memory, hooks, and so on) can be disabled instead of trashed, which moves it to ~/.local/share/fileblade/bin/ until you restore it
• Every file operation FileBlade performs is logged to ~/.local/state/omarchy/fileblade/audit.jsonl, and undo/redo works on them

Other

• Layout and settings live in ~/.config/omarchy/fileblade/

Details

This README is human-written and kept intentionally brief. Please check the below for details which are agent-written, but I've tried to keep responsibly clear to understand for you or your agent.

• Architecture: See ARCHITECTURE.md
• Security: See SECURITY.md
• Contributions: See CONTRIBUTING.md
• Extensions: See EXTENSIONS.md

License

MIT.