A terminal workspace with batteries included
Go to file
2022-01-25 22:17:19 +09:00
.github chore(deps): bump actions/upload-release-asset from 1.0.1 to 1.0.2 (#901) 2021-11-25 18:40:15 +01:00
assets chore(release): v0.24.0 2022-01-05 10:37:31 +01:00
default-plugins Add a copy command option (#996) 2022-01-15 12:38:45 +01:00
docs docs(manpage): Update manpage 2021-05-30 21:07:44 +02:00
example chore(release): v0.24.0 2022-01-05 10:37:31 +01:00
src chore(deps): update arg parsing to clap v3 (#1017) 2022-01-23 20:59:03 +01:00
zellij-client chore(version): bump development version 2022-01-05 11:14:15 +01:00
zellij-server feat: accept only printable unicode char (#1016) 2022-01-25 22:11:31 +09:00
zellij-tile chore(deps): update arg parsing to clap v3 (#1017) 2022-01-23 20:59:03 +01:00
zellij-tile-utils chore(version): bump development version 2022-01-05 11:14:15 +01:00
zellij-utils chore(deps): update arg parsing to clap v3 (#1017) 2022-01-23 20:59:03 +01:00
.gitignore simplify .gitignore (#783) 2021-10-18 10:46:00 +02:00
Cargo.lock chore(deps): update arg parsing to clap v3 (#1017) 2022-01-23 20:59:03 +01:00
Cargo.toml chore(version): bump development version 2022-01-05 11:14:15 +01:00
CHANGELOG.md docs(changelog): accept only printable unicode 2022-01-25 22:17:19 +09:00
CODE_OF_CONDUCT.md docs(coc): initial 2020-10-27 11:11:10 +01:00
CONTRIBUTING.md fix: Update CONTRIBUTING.md (#909) 2021-11-30 08:01:24 +01:00
docker-compose.yml fix(docker-compose): Use the key-value style for environments to prevent human errors (#840) 2021-11-09 20:29:22 +01:00
GOVERNANCE.md docs(governance): add myself to governance 2022-01-07 23:46:57 +09:00
LICENSE.md Update references of mosaic to Zellij in md files 2021-02-10 12:12:19 +05:30
Makefile.toml chore(build): fix publishing flow 2022-01-05 10:34:29 +01:00
README.md docs(readme): cross out roadmap goal and update demo 2021-12-22 09:20:45 +01:00
rust-toolchain feat(ui): overhauled resize and layout systems 2021-08-28 17:46:24 +01:00
test-template.yaml chore: update example layout (#926) 2021-12-09 18:38:18 +01:00
THIRD_PARTY_INSTALL.md docs(packaging): fedora COPR 2021-12-13 22:55:44 +01:00


logo
Zellij

demo

With Multiple Users:

demo

Discord Chat Matrix Chat Zellij documentation

What is this?

Zellij is a workspace aimed at developers, ops-oriented people and anyone who loves the terminal. At its core, it is a terminal multiplexer (similar to tmux and screen), but this is merely its infrastructure layer.

Zellij includes a layout system, and a plugin system allowing one to create plugins in any language that compiles to WebAssembly.

For more details about our future plans, read about upcoming features in our roadmap.

Zellij was initially called "Mosaic".

How do I install it?

You can install with cargo:

cargo install zellij

Or you can download a prebuilt binary from our Releases, or use Third Party Repositories.

The default plugins make use of characters that are mostly found in nerdfonts. To get the best experience either install nerdfonts, or use the simplified ui by starting Zellij with zellij options --simplified-ui true, or putting simplified_ui: true in the config file.

How do I get involved?

Zellij is a labour of love built by an enthusiastic team of volunteers. We eagerly welcome anyone who would like to join us, regardless of experience level, so long as they adhere to our code of conduct.

Please report any code of conduct violations to aram@poor.dev

To get started, you can:

  1. Take a look at the "Issues" in this repository - especially those marked "Good first issue". Those with the "Help Wanted" tag probably don't have anyone else working on them.
  2. Drop by our chat and ask what you can work on, or how to get started.
  3. Open an issue with your idea(s) for the project or tell us about them in our chat.

How do I start a development environment?

  • Clone the project
  • Install cargo-make with cargo install --force cargo-make
  • In the project folder, for debug builds run: cargo make run
  • To run all tests: cargo make test

For more build commands, see Contributing.md.

Configuration

For configuring Zellij, please see the Configuration documentation.

What is the current status of the project?

Zellij should be ready for everyday use, but it's still classified as a beta. This means that there might be a rare crash or wrong behaviour here and there, but that once found it should be fixed rather quickly. If this happens to you, we would be very happy if you could open an issue and tell us how to reproduce it as best you can.

Roadmap

This section contains an ever-changing list of the major features that are either currently being worked on, or planned for the near future.

  • Share sessions with others - See the focused window and cursor of other users, work on a problem or a code base together in real time. - implemented in 0.23.0
  • A web client/server - Connect to Zellij through the browser instead of opening a terminal window. Either on a local or remote machine.
  • Support for multiple terminal windows across screens - Transfer panes across different windows and screens by having them all belong to the same session.
  • Smart layouts - expand the current layout system so that it rearranges and hides panes intelligently when new ones are added or the window size is changed.

License

MIT