enwiro

Enwiro's aims to make window management as useful and convenient as possible with the goal of making you more productive.

The core feature of Enwiro is connecting your window manager's "workspace" (or similar) feature with separate environments that allow you to work with different projects or workflows.

Enwiro is window-manager-agnostic and relies on adapters to support different types of window managers and operating systems. Even if your window manager is not currently supported, it should be simple enough to create an adapter for it.

At their core, environments are simple working directories, and they might be generated using different plugins called cookbooks.

Enwiro is the successor to i3-env.

Usage

Integration with desktop environment

enwiro integrates with your desktop environment using adapters such as enwiro-adapter-i3wm. Adapters implement a set of basic features which enwiro can use in order to connect to your operating system's graphical environment.

Currently available adapters:

• enwiro-adapter-i3wm supports i3

Configuring desktop environment integration

enwiro adapters have names prefixed with enwiro-adapter- and can be installed using cargo. For example, to install an adapter for i3, you can run

cargo install enwiro-adapter-i3wm.

In your configuration file, set adapter to your desired adapter. For example, to use enwiro-adapter-i3wm, set adapter to i3wm.

adapter = "i3wm"

Concepts

Environment

An enwiro is a local folder or a symbolic link pointing to a folder.

An environment serves as a working directory for your applications, such as your terminal or your code editor.

An environment could be linked to:

• Any branch of a Git repository checked out on your local computer
• A folder on a remote computer
• Any folder on your computer

Recipe

Recipes are automatically generated blueprints for environments.

While they do not exist as environments on your computer yet, you can interact with them as if they were environments and when you do so, they will be created on the fly for you.

Recipes can have a hierarchical nature. For instance, the recipe for a Git repository might refer to the main working tree of the Git repository, and serve as the "parent recipe" to recipes for creating new worktrees for the same Git repository.

Cookbook

Cookbooks are plugins that contain recipes. You can add more recipes to your enwiro by installing and configuring more cookbooks.

List of currently available cookbooks:

• enwiro-cookbook-git: Generate environments using Git repositories