zellij README

The project's README from github.com/zellij-org/zellij. As one markdown file: README.md.


logo
Zellij

demo

[Installation] [Screencasts & Tutorials] [Configuration] [Layouts] [FAQ]

Discord Chat Matrix Chat Zellij documentation


Sponsored by     gresearch logo

What is this?

Zellij is a workspace aimed at developers, ops-oriented people and anyone who loves the terminal. Similar programs are sometimes called "Terminal Multiplexers".

Zellij is designed around the philosophy that one must not sacrifice simplicity for power, taking pride in its great experience out of the box as well as the advanced features it places at its users' fingertips.

Zellij is geared toward beginner and power users alike - allowing deep customizability, personal automation through layouts, true multiplayer collaboration, unique UX features such as floating and stacked panes, and a plugin system allowing one to create plugins in any language that compiles to WebAssembly.

Zellij includes a built-in web-client, making a terminal optional.

You can get started by installing Zellij and checking out the Screencasts & Tutorials.

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

How do I install it?

The easiest way to install Zellij is through a package for your OS.

If one is not available for your OS, you could download a prebuilt binary from the latest release and place it in your $PATH. If you'd like, we could automatically choose one for you.

You can also install (compile) with cargo:

cargo install --locked zellij

Try Zellij without installing

bash/zsh:

bash <(curl -L https://zellij.dev/launch)

fish/xonsh:

bash -c 'bash <(curl -L https://zellij.dev/launch)'

Installing from main

Installing Zellij from the main branch is not recommended. This branch represents pre-release code, is constantly being worked on and may contain broken or unusable features. In addition, using it may corrupt the cache for future versions, forcing users to clear it before they can use the officially released version.

That being said - no-one will stop you from using it (and bug reports involving new features are greatly appreciated), but please consider using the latest release instead as detailed at the top of this section.

How do I start a development environment?

For more build commands, see CONTRIBUTING.md.

Configuration

For configuring Zellij, please see the Configuration Documentation.

About issues in this repository

Issues in this repository, whether open or closed, do not necessarily indicate a problem or a bug in the software. They only indicate that the reporter wanted to communicate their experiences or thoughts to the maintainers. The Zellij maintainers do their best to go over and reply to all issue reports, but unfortunately cannot promise these will always be dealt with or even read. Your understanding is appreciated.

Roadmap

Presented here is the project roadmap, divided into three main sections.

These are issues that are either being actively worked on or are planned for the near future.

If you'll click on the image, you'll be led to an SVG version of it on the website where you can directly click on every issue

roadmap

Origin of the Name

From Wikipedia, the free encyclopedia

Zellij (Arabic: الزليج, romanized: zillīj; also spelled zillij or zellige) is a style of mosaic tilework made from individually hand-chiseled tile pieces. The pieces were typically of different colours and fitted together to form various patterns on the basis of tessellations, most notably elaborate Islamic geometric motifs such as radiating star patterns composed of various polygons. This form of Islamic art is one of the main characteristics of architecture in the western Islamic world. It is found in the architecture of Morocco, the architecture of Algeria, early Islamic sites in Tunisia, and in the historic monuments of al-Andalus (in the Iberian Peninsula).

License

MIT

Sponsored by

zellij (zellij-org/zellij)

Searching Database…

35.8K ·GitHub
What is this?Zellij is a terminal workspace (often called a terminal multiplexer) that lets you split your terminal into panes and tabs, with layouts, plugins, and a focus on being easy to use out of the box while still powerful.
Is this a library or something I run directly in my terminal?It's a standalone terminal application (TUI) you run directly, not a library you import into code.
How do I install and start using it?Install it via an OS package manager, download a prebuilt binary from the latest release and put it in your $PATH, or compile it with cargo.
Do I need Rust or cargo to run it?No, you only need cargo if you want to build it from source; precompiled binaries and OS packages are available otherwise.
Should I use the main branch build?No, the main branch is pre-release code that can be broken or unusable and may even corrupt the cache for future official releases, so it's recommended to stick with the latest release.
Who is this aimed at?It's built for both beginners and power users of the terminal, including developers and ops-oriented people, with deep customizability for advanced users.
Does it work on Linux and macOS?Yes, platform tags and packaging confirm Linux and macOS support, and it also runs through a browser via its built-in web client.
Can multiple people share a terminal session at the same time?Yes, Zellij supports true multiplayer collaboration, so multiple users can work in the same terminal session together.
Can I write plugins for Zellij in any language?Yes, Zellij has a plugin system that supports any language which compiles to WebAssembly.
Can I use Zellij without installing it first?Yes, the README mentions a way to try Zellij without installing, with separate instructions for bash/zsh and fish/xonsh shells.
Where does the name Zellij come from?Zellij is named after a traditional style of Islamic mosaic tilework made from hand-chiseled tile pieces forming geometric patterns, found in Moroccan, Algerian, Tunisian, and Andalusian architecture.
What are similar projects?herdr, yazi, coreutils, cocode, soundcraft, tuios, wezterm, neovim
Creator
zellij-org
Size
266.1 MB
Stars
35.8K
Age
6y
Commits · 90 Days