otty / apps

All apps/Zellij

Zellij

zellij

A workspace aimed at developers, ops-oriented people and anyone who loves the terminal.

Runs as zellij|macOS, Linux|zellij.dev

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

Zellij in your home directory Every rule on this page, by file

· config.kdl Sync

· layouts/ Sync

· themes/ Sync

· config.kdl Sync

· layouts/ Sync

· themes/ Sync

· Caches/org.Zellij-Contributors.Zellij/ Exclude

· ~/.cache/zellij/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/zellij/otty.tomlThe file this page is generated from

id = "zellij"

name = "Zellij"

homepage = "https://zellij.dev"

description = "A workspace aimed at developers, ops-oriented people and anyone who loves the terminal."

# Zellij's own logo. zellij.dev serves only the PNG, which is too large

# for the icon pipeline to take.

icon = "https://raw.githubusercontent.com/zellij-org/zellij/main/assets/logo.svg"

executables = ["zellij"]

platforms = ["macos", "linux"]

[dotfiles]

# https://zellij.dev/documentation/configuration — the lookup order is the

# --config-dir flag, then $ZELLIJ_CONFIG_DIR, then $HOME/.config/zellij, then

# the platform default, which on macOS is

# ~/Library/Application Support/org.Zellij-Contributors.Zellij. Both are

# listed because both are searched on a Mac; a consumer skips the one that is

# not there. Layouts live in the config directory's `layouts` folder

# (https://zellij.dev/documentation/layouts) and themes in CONFIG_DIR/themes

# (https://zellij.dev/documentation/themes). /etc/zellij is the system

# location and is not user-level.

paths = [

"~/.config/zellij/config.kdl",

"~/.config/zellij/layouts/",

"~/.config/zellij/themes/",

"~/Library/Application Support/org.Zellij-Contributors.Zellij/config.kdl",

"~/Library/Application Support/org.Zellij-Contributors.Zellij/layouts/",

"~/Library/Application Support/org.Zellij-Contributors.Zellij/themes/",

]

# Downloaded plugins and the session cache, which Zellij refetches. Two

# directories rather than two spellings of one, so neither is `[xdgCache]`:

# the cache follows the same split as the config above, ~/.cache/zellij where

# the XDG variables apply and the reverse-DNS

# ~/Library/Caches/org.Zellij-Contributors.Zellij on macOS, whose last segment

# is not even the same name.

exclude = [

"~/.cache/zellij/",

"~/Library/Caches/org.Zellij-Contributors.Zellij/",

]

secret = []

# No machine_lines: config.kdl is keybindings, themes, pane and mouse

# preferences. It is KDL, which none of the three parsers this catalog names

# can read, so a key_path rule could not be applied to it in any case. A

# running zellij server holds the config in memory, so side_effect stays at

# its default of true.

[commands]

format = 1

label = "Zellij"

description = "Start, attach to and manage Zellij sessions. Actions, plugins, pipes and config conversion are outside this form."

quality = "ai-draft"

base = "fig:zellij"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/zellij.ts"

license = "MIT"

[[commands.subcommand]]

path = ["attach"]

label = "Attach to a session"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/zellij.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "session"

label = "Session name"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "create"

label = "Create if missing"

type = "boolean"

option = ["--create", "-c"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "background"

label = "Create detached in background"

type = "boolean"

option = ["--background", "-b"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "force_run"

label = "Run resurrected commands immediately"

type = "boolean"

option = ["--force-run-commands", "-f"]

effect = "exec"

sources = ["fig"]

[[commands.subcommand.task]]

id = "attach"

label = "Attach"

fields = ["session", "create"]

required = []

[[commands.subcommand.task]]

id = "attach-or-create"

label = "Attach or create"

set = { create = [true] }

lock = ["create"]

fields = ["session"]

required = ["session"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["session", "create"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["background", "force_run"]

[[commands.subcommand]]

path = ["list-sessions"]

label = "List sessions"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/zellij.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "short"

label = "Names only"

type = "boolean"

option = ["--short", "-s"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "no_formatting"

label = "No colors"

type = "boolean"

option = ["--no-formatting", "-n"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "reverse"

label = "Reverse order"

type = "boolean"

option = ["--reverse", "-r"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "list"

label = "List sessions"

fields = ["short", "no_formatting", "reverse"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["short", "no_formatting", "reverse"]

[[commands.subcommand]]

path = ["kill-session"]

label = "Kill a session"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/zellij.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "target"

label = "Session name"

type = "string"

position = 0

min = 1

effect = "delete"

sources = ["fig"]

[[commands.subcommand.task]]

id = "kill"

label = "Kill session"

fields = ["target"]

required = ["target"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["target"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/zellij. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.