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"]