d1f50150f6
* xtask: Implement a new build system xtask is a cargo alias that is used to extend the cargo build system with custom commands. For an introduction to xtask, see here: https://github.com/matklad/cargo-xtask/ The idea is that instead of writing makefiles, xtask requires no additional dependencies except `cargo` and `rustc`, which must be available to build the project anyway. This commit provides a basic implementation of the `build` and `test` subcommands. * xtask/deps: Add 'which' * xtask/test: Handle error when cargo not found * xtask/flags: Add more commands to perform different useful tasks. Includes: - clippy - format - "make" (composite) - "install" (composite) Also add more options to `build` to selectively compile plugins or leave them out entirely. * xtask/main: Return error when cargo not found * xtask/build: Add more subtasks - `wasm_opt_plugins` and - `manpage` that perform other build commands. Add thorough documentation on what each of these does and also handle the new `build` cli flags appropriately. * xtask/clippy: Add job to run clippy * xtask/format: Add job to run rustfmt * xtask/pipeline: Add composite commands that perform multiple atomic xtask commands sequentially in a pipeline sort of fashion. * xtask/deps: Pin dependencies * xtask/main: Integrate new jobs and add documentation. * xtask: Implement 'dist' which performs an 'install' and copies the resulting zellij binary along with some other assets to a `target/dist` folder. * cargo: Update xflags version * xtask: Measure task time, update tty title * xtask: Update various tasks * xtask: wasm-opt plugins in release builds automatically. * xtask/build: Copy debug plugins to assets folder * xtask: Add 'run' subcommand * xtask: Add arbitrary args to test and run * xtask: Rearrange CLI commands in help * xtask: Add deprecation notice * docs: Replace `cargo make` with `xtask` * github: Use `xtask` in workflows. * xtask: Add support for CI commands * xtask: Streamline error handling * github: Use new xtask commands in CI * xtask: Add 'publish' job * xtask/publish: Add retry when publish fails * xtask: Apply rustfmt * xtask: Refine 'make' deprecation warning * xtask: add task to build manpage * contributing: Fix e2e commands * xtask/run: Add missing `--` to pass all arguments following `xtask run` directly to the zellij binary being run. * xtask: Stay in invocation dir and make all tasks that need it change to the project root dir themselves. * xtask/run: Add `--data-dir` flag which will allow very quick iterations when not changing the plugins between builds. * xtask/ci: Install dependencies without asking * utils: Allow including plugins from target folder * utils/assets: Reduce asset map complexity * utils/consts: Update asset map docs * xtask: Fix plugin includes * xtask/test: Build plugins first because the zellij binary needs to include the plugins. * xtask/test: Fix formatting * xtask: Add notice on how to disable it
108 lines
4.9 KiB
Markdown
108 lines
4.9 KiB
Markdown
<h1 align="center">
|
|
<br>
|
|
<img src="https://raw.githubusercontent.com/zellij-org/zellij/main/assets/logo.png" alt="logo" width="200">
|
|
<br>
|
|
Zellij
|
|
<br>
|
|
<br>
|
|
</h1>
|
|
|
|
<p align="center">
|
|
<a href="https://discord.gg/CrUAFH3"><img alt="Discord Chat" src="https://img.shields.io/discord/771367133715628073?color=5865F2&label=discord&style=flat-square"></a>
|
|
<a href="https://matrix.to/#/#zellij_general:matrix.org"><img alt="Matrix Chat" src="https://img.shields.io/matrix/zellij_general:matrix.org?color=1d7e64&label=matrix%20chat&style=flat-square&logo=matrix"></a>
|
|
<a href="https://zellij.dev/documentation/"><img alt="Zellij documentation" src="https://img.shields.io/badge/zellij-documentation-fc0060?style=flat-square"></a>
|
|
<a href="https://builtwithnix.org"><img alt="Built with nix" src="https://img.shields.io/static/v1?label=built%20with&message=nix&color=5277C3&logo=nixos&style=flat-square&logoColor=ffffff"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="https://raw.githubusercontent.com/zellij-org/zellij/main/assets/demo.gif" alt="demo">
|
|
</p>
|
|
|
|
<h4 align="center">
|
|
[<a href="https://zellij.dev/documentation/installation">Installation</a>]
|
|
[<a href="https://zellij.dev/documentation/overview">Overview</a>]
|
|
[<a href="https://zellij.dev/documentation/configuration">Configuration</a>]
|
|
[<a href="https://zellij.dev/documentation/layouts-templates">Templates</a>]
|
|
[<a href="https://zellij.dev/documentation/faq">FAQ</a>]
|
|
</h4>
|
|
|
|
# What is this?
|
|
|
|
[Zellij](https://en.wikipedia.org/wiki/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](https://github.com/tmux/tmux) and [GNU Screen](https://www.gnu.org/software/screen/)), but this is merely its infrastructure layer.
|
|
|
|
Zellij includes a [layout system](https://zellij.dev/documentation/layouts.html), and a [plugin system](https://zellij.dev/documentation/plugins.html) allowing one to create plugins in any language that compiles to WebAssembly.
|
|
|
|
You can get started by [installing](https://zellij.dev/documentation/installation.html) Zellij and reading the [overview](https://zellij.dev/documentation/overview.html).
|
|
|
|
For more details about our future plans, read about upcoming features in our [roadmap](#roadmap).
|
|
|
|
Zellij was initially called ***Mosaic***.
|
|
|
|
## How do I install it?
|
|
|
|
You can install with `cargo`:
|
|
|
|
```
|
|
cargo install --locked zellij
|
|
```
|
|
|
|
Or if want to a prebuilt binary, you can download it from our [releases](https://github.com/zellij-org/zellij/releases), or use [`cargo-binstall`](https://github.com/ryankurte/cargo-binstall).
|
|
|
|
```
|
|
cargo-binstall zellij
|
|
```
|
|
|
|
Or you can also use [Third Party Repositories](./docs/THIRD_PARTY_INSTALL.md).
|
|
|
|
#### Try Zellij without installing
|
|
|
|
bash/zsh:
|
|
```
|
|
bash <(curl -L zellij.dev/launch)
|
|
```
|
|
fish:
|
|
```
|
|
bash (curl -L zellij.dev/launch | psub)
|
|
```
|
|
|
|
## 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](CODE_OF_CONDUCT.md).
|
|
|
|
Please report any code of conduct violations to [aram@poor.dev](mailto:aram@poor.dev)
|
|
|
|
To get started, you can:
|
|
1. Take a look at the [Issues](https://github.com/zellij-org/zellij/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 [Discord](https://discord.gg/CrUAFH3), or [Matrix](https://matrix.to/#/#zellij_general:matrix.org) 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
|
|
* In the project folder, for debug builds run: `cargo xtask run`
|
|
* To run all tests: `cargo xtask test`
|
|
|
|
For more build commands, see [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
|
## Configuration
|
|
For configuring Zellij, please see the [Configuration Documentation](https://zellij.dev/documentation/configuration.html).
|
|
|
|
## 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
|
|
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***
|
|
|
|
[](https://zellij.dev/roadmap)
|
|
|
|
## License
|
|
|
|
MIT
|