Merge 853e4f4e6c into 92aed2e936

Add unar as a fallback when unrar is not available for extracting
RAR files. This addresses the issue where unrar has been removed
from Homebrew due to licensing issues.

The extraction now:
- Prefers unrar if available (backward compatible)
- Falls back to unar if unrar is not found
- Shows helpful error message if neither tool is installed

plugins/container/README.md

@@ -0,0 +1,121 @@
+# Container Plugin
+
+This plugin provides autocompletion and aliases for Apple's [container](https://github.com/apple/container) tool - a tool for creating and running Linux containers using lightweight virtual machines on macOS with Apple silicon.
+
+## Usage
+
+To use this plugin, add `container` to the plugins array in your `~/.zshrc` file:
+
+```bash
+plugins=(... container)
+```
+
+## Requirements
+
+- macOS 26 or later
+- Apple silicon Mac
+- [Apple container](https://github.com/apple/container) tool installed
+
+## Aliases
+
+### Core Commands
+- `cb` → `container build`
+- `ccr` → `container create`
+- `cst` → `container start`
+- `csp` → `container stop`
+- `ck` → `container kill`
+- `cdl` → `container delete`
+- `crm` → `container delete`
+- `cls` → `container list`
+- `clsa` → `container list -a`
+- `cex` → `container exec`
+- `cexit` → `container exec -it`
+- `clo` → `container logs`
+- `clof` → `container logs -f`
+- `cin` → `container inspect`
+- `cr` → `container run`
+- `crit` → `container run -it`
+- `crd` → `container run -d`
+
+### Image Management
+- `cils` → `container image list`
+- `cipl` → `container image pull`
+- `cips` → `container image push`
+- `cisv` → `container image save`
+- `cild` → `container image load`
+- `citg` → `container image tag`
+- `cirm` → `container image delete`
+- `cipr` → `container image prune`
+- `ciin` → `container image inspect`
+
+### Builder Management
+- `cbst` → `container builder start`
+- `cbsp` → `container builder stop`
+- `cbss` → `container builder status`
+- `cbrm` → `container builder delete`
+
+### Network Management (macOS 26+)
+- `cncr` → `container network create`
+- `cnrm` → `container network delete`
+- `cnls` → `container network list`
+- `cnin` → `container network inspect`
+
+### Volume Management
+- `cvcr` → `container volume create`
+- `cvrm` → `container volume delete`
+- `cvls` → `container volume list`
+- `cvin` → `container volume inspect`
+
+### Registry Management
+- `crli` → `container registry login`
+- `crlo` → `container registry logout`
+
+### System Management
+- `csst` → `container system start`
+- `cssp` → `container system stop`
+- `csss` → `container system status`
+- `cslo` → `container system logs`
+- `cske` → `container system kernel set`
+- `cspl` → `container system property list`
+- `cspg` → `container system property get`
+- `csps` → `container system property set`
+- `cspc` → `container system property clear`
+
+## Autocompletion
+
+The plugin provides comprehensive autocompletion for:
+
+- All container commands and subcommands
+- Container IDs (running, stopped, or all)
+- Image names and tags
+- Network names
+- Volume names
+- Command-specific options and flags
+- File paths for relevant commands
+
+## Installation
+
+If you're using Oh My Zsh with custom plugins:
+
+1. Clone or copy this plugin to your custom plugins directory:
+   ```bash
+   cp -r container ~/.oh-my-zsh/custom/plugins/
+   ```
+
+2. Add `container` to your plugins list in `~/.zshrc`:
+   ```bash
+   plugins=(... container)
+   ```
+
+3. Restart your shell or run:
+   ```bash
+   source ~/.zshrc
+   ```
+
+## Contributing
+
+This plugin is based on the official Apple container command reference. If you find any issues or missing completions, please report them or submit a pull request.
+
+## License
+
+This plugin is released under the same license as Oh My Zsh.

plugins/container/completions/_container

@@ -0,0 +1,699 @@
+#compdef container
+#
+# zsh completion for Apple container (https://github.com/apple/container)
+#
+# version: 1.0.0
+# 
+
+__container_arguments() {
+    if zstyle -t ":completion:${curcontext}:" option-stacking; then
+        print -- -s
+    fi
+}
+
+# Helper function to get running containers
+__container_get_containers() {
+    local state=$1
+    local -a containers
+    case $state in
+        running)
+            containers=(${(f)"$(container list --quiet 2>/dev/null)"})
+            ;;
+        all)
+            containers=(${(f)"$(container list --all --quiet 2>/dev/null)"})
+            ;;
+        *)
+            containers=(${(f)"$(container list --all --quiet 2>/dev/null)"})
+            ;;
+    esac
+    _describe 'containers' containers
+}
+
+# Helper function to get images
+__container_get_images() {
+    local -a images
+    images=(${(f)"$(container image list --quiet 2>/dev/null)"})
+    _describe 'images' images
+}
+
+# Helper function to get networks
+__container_get_networks() {
+    local -a networks
+    networks=(${(f)"$(container network list --quiet 2>/dev/null)"})
+    _describe 'networks' networks
+}
+
+# Helper function to get volumes
+__container_get_volumes() {
+    local -a volumes
+    volumes=(${(f)"$(container volume list --quiet 2>/dev/null)"})
+    _describe 'volumes' volumes
+}
+
+# Main command structure
+_container() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '--debug[Enable debug output]' \
+        '--version[Show the version]' \
+        '--help[Show help information]' \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'run:Run a container from an image'
+                'build:Build an OCI image from a local build context'
+                'create:Create a container from an image without starting it'
+                'start:Start a stopped container'
+                'stop:Stop running containers gracefully'
+                'kill:Immediately kill running containers'
+                'delete:Remove one or more containers'
+                'rm:Remove one or more containers'
+                'list:List containers'
+                'ls:List containers'
+                'exec:Execute a command inside a running container'
+                'logs:Fetch logs from a container'
+                'inspect:Display detailed container information'
+                'image:Manage images'
+                'builder:Manage BuildKit builder'
+                'network:Manage networks'
+                'volume:Manage volumes'
+                'registry:Manage registry authentication'
+                'system:Manage container system'
+            )
+            _describe 'commands' commands
+            ;;
+        args)
+            case $words[1] in
+                run)
+                    _container_run
+                    ;;
+                build)
+                    _container_build
+                    ;;
+                create)
+                    _container_create
+                    ;;
+                start)
+                    _container_start
+                    ;;
+                stop)
+                    _container_stop
+                    ;;
+                kill)
+                    _container_kill
+                    ;;
+                delete|rm)
+                    _container_delete
+                    ;;
+                list|ls)
+                    _container_list
+                    ;;
+                exec)
+                    _container_exec
+                    ;;
+                logs)
+                    _container_logs
+                    ;;
+                inspect)
+                    _container_inspect
+                    ;;
+                image)
+                    _container_image
+                    ;;
+                builder)
+                    _container_builder
+                    ;;
+                network)
+                    _container_network
+                    ;;
+                volume)
+                    _container_volume
+                    ;;
+                registry)
+                    _container_registry
+                    ;;
+                system)
+                    _container_system
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container_run() {
+    _arguments $(__container_arguments) \
+        '(-e --env)'{-e,--env}'[Set environment variables (format: key=value)]:env var:' \
+        '--env-file[Read environment variables from file]:env file:_files' \
+        '--gid[Set the group ID for the process]:gid:' \
+        '(-i --interactive)'{-i,--interactive}'[Keep standard input open]' \
+        '(-t --tty)'{-t,--tty}'[Open a TTY with the process]' \
+        '(-u --user)'{-u,--user}'[Set the user for the process]:user:' \
+        '--uid[Set the user ID for the process]:uid:' \
+        '(-w --workdir --cwd)'{-w,--workdir,--cwd}'[Set the initial working directory]:workdir:_directories' \
+        '(-c --cpus)'{-c,--cpus}'[Number of CPUs to allocate]:cpus:' \
+        '(-m --memory)'{-m,--memory}'[Amount of memory]:memory:' \
+        '(-a --arch)'{-a,--arch}'[Set arch if image can target multiple architectures]:arch:(arm64 x86_64)' \
+        '--cidfile[Write the container ID to the path provided]:cidfile:_files' \
+        '(-d --detach)'{-d,--detach}'[Run the container and detach from the process]' \
+        '--dns[DNS nameserver IP address]:dns ip:' \
+        '--dns-domain[Default DNS domain]:dns domain:' \
+        '--dns-option[DNS options]:dns option:' \
+        '--dns-search[DNS search domains]:dns search:' \
+        '--entrypoint[Override the entrypoint of the image]:entrypoint:' \
+        '(-k --kernel)'{-k,--kernel}'[Set a custom kernel path]:kernel path:_files' \
+        '(-l --label)'{-l,--label}'[Add a key=value label to the container]:label:' \
+        '--mount[Add a mount to the container]:mount:' \
+        '--name[Use the specified name as the container ID]:name:' \
+        '--network[Attach the container to a network]:network:__container_get_networks' \
+        '--no-dns[Do not configure DNS in the container]' \
+        '--os[Set OS if image can target multiple operating systems]:os:(linux)' \
+        '(-p --publish)'{-p,--publish}'[Publish a port]:port spec:' \
+        '--platform[Platform for the image]:platform:' \
+        '--publish-socket[Publish a socket]:socket spec:' \
+        '--rm[Remove the container after it stops]' \
+        '--ssh[Forward SSH agent socket to container]' \
+        '--tmpfs[Add a tmpfs mount]:tmpfs path:' \
+        '(-v --volume)'{-v,--volume}'[Bind mount a volume]:volume:' \
+        '--virtualization[Expose virtualization capabilities]' \
+        '--scheme[Scheme to use when connecting to registry]:scheme:(http https auto)' \
+        '--disable-progress-updates[Disable progress bar updates]' \
+        '1:image:__container_get_images' \
+        '*:command and args:'
+}
+
+_container_build() {
+    _arguments $(__container_arguments) \
+        '(-a --arch)'{-a,--arch}'[Add the architecture type to the build]:arch:(arm64 x86_64)' \
+        '--build-arg[Set build-time variables]:build arg:' \
+        '(-c --cpus)'{-c,--cpus}'[Number of CPUs to allocate to the builder]:cpus:' \
+        '(-f --file)'{-f,--file}'[Path to Dockerfile]:dockerfile:_files' \
+        '(-l --label)'{-l,--label}'[Set a label]:label:' \
+        '(-m --memory)'{-m,--memory}'[Amount of builder container memory]:memory:' \
+        '--no-cache[Do not use cache]' \
+        '(-o --output)'{-o,--output}'[Output configuration for the build]:output:' \
+        '--os[Add the OS type to the build]:os:(linux)' \
+        '--platform[Add the platform to the build]:platform:' \
+        '--progress[Progress type]:progress type:(auto plain tty)' \
+        '(-q --quiet)'{-q,--quiet}'[Suppress build output]' \
+        '(-t --tag)'{-t,--tag}'[Name for the built image]:tag:' \
+        '--target[Set the target build stage]:stage:' \
+        '--vsock-port[Builder shim vsock port]:port:' \
+        '1:context directory:_directories'
+}
+
+_container_create() {
+    # Same options as run, but without execution
+    _container_run
+}
+
+_container_start() {
+    _arguments $(__container_arguments) \
+        '(-a --attach)'{-a,--attach}'[Attach STDOUT/STDERR]' \
+        '(-i --interactive)'{-i,--interactive}'[Attach STDIN]' \
+        '1:container:__container_get_containers stopped'
+}
+
+_container_stop() {
+    _arguments $(__container_arguments) \
+        '(-a --all)'{-a,--all}'[Stop all running containers]' \
+        '(-s --signal)'{-s,--signal}'[Signal to send the containers]:signal:' \
+        '(-t --time)'{-t,--time}'[Seconds to wait before killing]:time:' \
+        '*:containers:__container_get_containers running'
+}
+
+_container_kill() {
+    _arguments $(__container_arguments) \
+        '(-a --all)'{-a,--all}'[Kill all running containers]' \
+        '(-s --signal)'{-s,--signal}'[Signal to send]:signal:' \
+        '*:containers:__container_get_containers running'
+}
+
+_container_delete() {
+    _arguments $(__container_arguments) \
+        '(-a --all)'{-a,--all}'[Remove all containers]' \
+        '(-f --force)'{-f,--force}'[Force the removal of running containers]' \
+        '*:containers:__container_get_containers all'
+}
+
+_container_list() {
+    _arguments $(__container_arguments) \
+        '(-a --all)'{-a,--all}'[Show stopped containers as well]' \
+        '--format[Format of the output]:format:(json table)' \
+        '(-q --quiet)'{-q,--quiet}'[Only output the container ID]'
+}
+
+_container_exec() {
+    _arguments $(__container_arguments) \
+        '(-e --env)'{-e,--env}'[Set environment variables]:env var:' \
+        '--env-file[Read environment variables from file]:env file:_files' \
+        '--gid[Set the group ID for the process]:gid:' \
+        '(-i --interactive)'{-i,--interactive}'[Keep standard input open]' \
+        '(-t --tty)'{-t,--tty}'[Open a TTY with the process]' \
+        '(-u --user)'{-u,--user}'[Set the user for the process]:user:' \
+        '--uid[Set the user ID for the process]:uid:' \
+        '(-w --workdir --cwd)'{-w,--workdir,--cwd}'[Set the initial working directory]:workdir:_directories' \
+        '1:container:__container_get_containers running' \
+        '*:command and args:'
+}
+
+_container_logs() {
+    _arguments $(__container_arguments) \
+        '--boot[Display the boot log for the container]' \
+        '(-f --follow)'{-f,--follow}'[Follow log output]' \
+        '-n[Number of lines to show from the end]:lines:' \
+        '1:container:__container_get_containers all'
+}
+
+_container_inspect() {
+    _arguments $(__container_arguments) \
+        '*:containers:__container_get_containers all'
+}
+
+_container_image() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'list:List local images'
+                'ls:List local images'
+                'pull:Pull an image from a registry'
+                'push:Push an image to a registry'
+                'save:Save an image to a tar archive'
+                'load:Load images from a tar archive'
+                'tag:Apply a new tag to an existing image'
+                'delete:Remove one or more images'
+                'rm:Remove one or more images'
+                'prune:Remove unused images'
+                'inspect:Show detailed information for images'
+            )
+            _describe 'image commands' commands
+            ;;
+        args)
+            case $words[1] in
+                list|ls)
+                    _arguments $(__container_arguments) \
+                        '(-q --quiet)'{-q,--quiet}'[Only output the image name]' \
+                        '(-v --verbose)'{-v,--verbose}'[Verbose output]' \
+                        '--format[Format of the output]:format:(json table)'
+                    ;;
+                pull)
+                    _arguments $(__container_arguments) \
+                        '--platform[Platform string]:platform:' \
+                        '--scheme[Scheme to use]:scheme:(http https auto)' \
+                        '--disable-progress-updates[Disable progress bar updates]' \
+                        '1:image reference:'
+                    ;;
+                push)
+                    _arguments $(__container_arguments) \
+                        '--platform[Platform string]:platform:' \
+                        '--scheme[Scheme to use]:scheme:(http https auto)' \
+                        '--disable-progress-updates[Disable progress bar updates]' \
+                        '1:image reference:__container_get_images'
+                    ;;
+                save)
+                    _arguments $(__container_arguments) \
+                        '--platform[Platform string]:platform:' \
+                        '(-o --output)'{-o,--output}'[Path to save the image tar archive]:output file:_files' \
+                        '1:image reference:__container_get_images'
+                    ;;
+                load)
+                    _arguments $(__container_arguments) \
+                        '(-i --input)'{-i,--input}'[Path to the tar archive]:input file:_files'
+                    ;;
+                tag)
+                    _arguments $(__container_arguments) \
+                        '1:source image:__container_get_images' \
+                        '2:target image:'
+                    ;;
+                delete|rm)
+                    _arguments $(__container_arguments) \
+                        '(-a --all)'{-a,--all}'[Remove all images]' \
+                        '*:images:__container_get_images'
+                    ;;
+                prune)
+                    _arguments $(__container_arguments)
+                    ;;
+                inspect)
+                    _arguments $(__container_arguments) \
+                        '*:images:__container_get_images'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container_builder() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'start:Start the BuildKit builder container'
+                'stop:Stop the BuildKit builder'
+                'status:Show the current status of the BuildKit builder'
+                'delete:Remove the BuildKit builder container'
+                'rm:Remove the BuildKit builder container'
+            )
+            _describe 'builder commands' commands
+            ;;
+        args)
+            case $words[1] in
+                start)
+                    _arguments $(__container_arguments) \
+                        '(-c --cpus)'{-c,--cpus}'[Number of CPUs to allocate]:cpus:' \
+                        '(-m --memory)'{-m,--memory}'[Amount of memory]:memory:'
+                    ;;
+                status)
+                    _arguments $(__container_arguments) \
+                        '--json[Output status as JSON]'
+                    ;;
+                delete|rm)
+                    _arguments $(__container_arguments) \
+                        '(-f --force)'{-f,--force}'[Force deletion even if the builder is running]'
+                    ;;
+                stop)
+                    _arguments $(__container_arguments)
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container_network() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'create:Create a new network'
+                'delete:Delete one or more networks'
+                'rm:Delete one or more networks'
+                'list:List user-defined networks'
+                'ls:List user-defined networks'
+                'inspect:Show detailed information about networks'
+            )
+            _describe 'network commands' commands
+            ;;
+        args)
+            case $words[1] in
+                create)
+                    _arguments $(__container_arguments) \
+                        '--label[Set metadata labels on the network]:label:' \
+                        '1:network name:'
+                    ;;
+                delete|rm)
+                    _arguments $(__container_arguments) \
+                        '(-a --all)'{-a,--all}'[Delete all defined networks]' \
+                        '*:networks:__container_get_networks'
+                    ;;
+                list|ls)
+                    _arguments $(__container_arguments) \
+                        '(-q --quiet)'{-q,--quiet}'[Only output the network name]' \
+                        '--format[Format of the output]:format:(json table)'
+                    ;;
+                inspect)
+                    _arguments $(__container_arguments) \
+                        '*:networks:__container_get_networks'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container_volume() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'create:Create a new volume'
+                'delete:Remove one or more volumes'
+                'rm:Remove one or more volumes'
+                'list:List volumes'
+                'ls:List volumes'
+                'inspect:Display detailed information for volumes'
+            )
+            _describe 'volume commands' commands
+            ;;
+        args)
+            case $words[1] in
+                create)
+                    _arguments $(__container_arguments) \
+                        '-s[Size of the volume]:size:' \
+                        '--opt[Set driver-specific options]:option:' \
+                        '--label[Set metadata labels on the volume]:label:' \
+                        '1:volume name:'
+                    ;;
+                delete|rm)
+                    _arguments $(__container_arguments) \
+                        '*:volumes:__container_get_volumes'
+                    ;;
+                list|ls)
+                    _arguments $(__container_arguments) \
+                        '(-q --quiet)'{-q,--quiet}'[Only display volume names]' \
+                        '--format[Format of the output]:format:(json table)'
+                    ;;
+                inspect)
+                    _arguments $(__container_arguments) \
+                        '*:volumes:__container_get_volumes'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container_registry() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'login:Authenticate with a registry'
+                'logout:Log out of a registry'
+            )
+            _describe 'registry commands' commands
+            ;;
+        args)
+            case $words[1] in
+                login)
+                    _arguments $(__container_arguments) \
+                        '(-u --username)'{-u,--username}'[Username for the registry]:username:' \
+                        '--password-stdin[Read the password from STDIN]' \
+                        '--scheme[Registry scheme]:scheme:(http https auto)' \
+                        '1:server:'
+                    ;;
+                logout)
+                    _arguments $(__container_arguments) \
+                        '1:server:'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container_system() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'start:Start the container services'
+                'stop:Stop the container services'
+                'status:Check whether the container services are running'
+                'logs:Display logs from the container services'
+                'dns:Manage local DNS domains'
+                'kernel:Manage the Linux kernel'
+                'property:Manage system properties'
+            )
+            _describe 'system commands' commands
+            ;;
+        args)
+            case $words[1] in
+                start)
+                    _arguments $(__container_arguments) \
+                        '(-a --app-root)'{-a,--app-root}'[Application data directory]:app root:_directories' \
+                        '--install-root[Path to the installation root directory]:install root:_directories' \
+                        '--debug[Enable debug logging for the runtime daemon]' \
+                        '--enable-kernel-install[Install the recommended default kernel]' \
+                        '--disable-kernel-install[Skip installing the default kernel]'
+                    ;;
+                stop)
+                    _arguments $(__container_arguments) \
+                        '(-p --prefix)'{-p,--prefix}'[Launchd prefix]:prefix:'
+                    ;;
+                status)
+                    _arguments $(__container_arguments) \
+                        '(-p --prefix)'{-p,--prefix}'[Launchd prefix to query]:prefix:'
+                    ;;
+                logs)
+                    _arguments $(__container_arguments) \
+                        '--last[Fetch logs starting from the specified time period]:duration:' \
+                        '(-f --follow)'{-f,--follow}'[Follow log output]'
+                    ;;
+                dns)
+                    _container_system_dns
+                    ;;
+                kernel)
+                    _container_system_kernel
+                    ;;
+                property)
+                    _container_system_property
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container_system_dns() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'create:Create a local DNS domain'
+                'delete:Delete a local DNS domain'
+                'rm:Delete a local DNS domain'
+                'list:List configured local DNS domains'
+                'ls:List configured local DNS domains'
+            )
+            _describe 'dns commands' commands
+            ;;
+        args)
+            case $words[1] in
+                create|delete|rm)
+                    _arguments $(__container_arguments) \
+                        '1:domain name:'
+                    ;;
+                list|ls)
+                    _arguments $(__container_arguments)
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container_system_kernel() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'set:Install or update the Linux kernel'
+            )
+            _describe 'kernel commands' commands
+            ;;
+        args)
+            case $words[1] in
+                set)
+                    _arguments $(__container_arguments) \
+                        '--binary[Path to a kernel binary]:kernel binary:_files' \
+                        '--tar[Path or URL to a tarball containing kernel images]:tar file:_files' \
+                        '--arch[Target architecture]:arch:(arm64 x86_64)' \
+                        '--recommended[Download and install the recommended default kernel]'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container_system_property() {
+    local curcontext="$curcontext" state line
+    local -A opt_args
+
+    _arguments $(__container_arguments) \
+        '1: :->command' \
+        '*:: :->args' && return 0
+
+    case $state in
+        command)
+            local -a commands
+            commands=(
+                'list:List all available system properties'
+                'ls:List all available system properties'
+                'get:Retrieve the current value of a system property'
+                'set:Set the value of a system property'
+                'clear:Clear a system property'
+            )
+            _describe 'property commands' commands
+            ;;
+        args)
+            case $words[1] in
+                list|ls)
+                    _arguments $(__container_arguments) \
+                        '(-q --quiet)'{-q,--quiet}'[Only output the property IDs]' \
+                        '--format[Format of the output]:format:(json table)'
+                    ;;
+                get)
+                    _arguments $(__container_arguments) \
+                        '1:property id:'
+                    ;;
+                set)
+                    _arguments $(__container_arguments) \
+                        '1:property id:' \
+                        '2:value:'
+                    ;;
+                clear)
+                    _arguments $(__container_arguments) \
+                        '1:property id:'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_container "$@"

plugins/container/container.plugin.zsh

@@ -0,0 +1,88 @@
+# Container plugin for Apple's container tool
+# https://github.com/apple/container
+
+# Aliases for common container commands
+alias cb='container build'
+alias ccr='container create'
+alias cst='container start'
+alias csp='container stop'
+alias ck='container kill'
+alias cdl='container delete'
+alias crm='container delete'
+alias cls='container list'
+alias clsa='container list -a'
+alias cex='container exec'
+alias cexit='container exec -it'
+alias clo='container logs'
+alias clof='container logs -f'
+alias cin='container inspect'
+alias cr='container run'
+alias crit='container run -it'
+alias crd='container run -d'
+
+# Image management aliases
+alias cils='container image list'
+alias cipl='container image pull'
+alias cips='container image push'
+alias cisv='container image save'
+alias cild='container image load'
+alias citg='container image tag'
+alias cirm='container image delete'
+alias cipr='container image prune'
+alias ciin='container image inspect'
+
+# Builder management aliases
+alias cbst='container builder start'
+alias cbsp='container builder stop'
+alias cbss='container builder status'
+alias cbrm='container builder delete'
+
+# Network management aliases (macOS 26+)
+alias cncr='container network create'
+alias cnrm='container network delete'
+alias cnls='container network list'
+alias cnin='container network inspect'
+
+# Volume management aliases
+alias cvcr='container volume create'
+alias cvrm='container volume delete'
+alias cvls='container volume list'
+alias cvin='container volume inspect'
+
+# Registry management aliases
+alias crli='container registry login'
+alias crlo='container registry logout'
+
+# System management aliases
+alias csst='container system start'
+alias cssp='container system stop'
+alias csss='container system status'
+alias cslo='container system logs'
+alias cske='container system kernel set'
+alias cspl='container system property list'
+alias cspg='container system property get'
+alias csps='container system property set'
+alias cspc='container system property clear'
+
+# Check if container command is available
+if (( ! $+commands[container] )); then
+  return
+fi
+
+# Standardized $0 handling
+# https://zdharma-continuum.github.io/Zsh-100-Commits-Club/Zsh-Plugin-Standard.html
+0="${${ZERO:-${0:#$ZSH_ARGZERO}}:-${(%):-%N}}"
+0="${${(M)0:#/*}:-$PWD/$0}"
+
+# If the completion file doesn't exist yet, we need to autoload it and
+# bind it to `container`. Otherwise, compinit will have already done that.
+if [[ ! -f "$ZSH_CACHE_DIR/completions/_container" ]]; then
+  typeset -g -A _comps
+  autoload -Uz _container
+  _comps[container]=_container
+fi
+
+{
+  # Copy the custom completion file to cache
+  command cp "${0:h}/completions/_container" "$ZSH_CACHE_DIR/completions/_container"
+} &|

plugins/extract/extract.plugin.zsh

@@ -77,7 +77,15 @@ EOF
       (*.lzma) unlzma "$full_path" ;;
       (*.z) uncompress "$full_path" ;;
       (*.zip|*.war|*.jar|*.ear|*.sublime-package|*.ipa|*.ipsw|*.xpi|*.apk|*.aar|*.whl|*.vsix|*.crx|*.pk3|*.pk4) unzip "$full_path" ;;
-      (*.rar) unrar x -ad "$full_path" ;;
+      (*.rar)
+        if (( $+commands[unrar] )); then
+          unrar x -ad "$full_path"
+        elif (( $+commands[unar] )); then
+          unar -o . "$full_path"
+        else
+          echo "extract: cannot extract RAR files: install unrar or unar" >&2
+          success=1
+        fi ;;
       (*.rpm)
         rpm2cpio "$full_path" | cpio --quiet -id ;;
       (*.7z | *.7z.[0-9]* | *.pk7) 7za x "$full_path" ;;