# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later

# SYNOPSIS
#   bkg <command> [args...]
#
# DESCRIPTION
#   Launches a command in the background, fully detached from the terminal
#   using nohup. All stdout and stderr output is discarded.
#
# ARGUMENTS
#   command  The command to run detached
#   args...  Additional arguments for the command
#
# RETURNS
#   0  Command launched successfully
#   1  No command provided
#
# EXAMPLE
#   bkg firefox
function bkg --description 'Execute bkg'
    # Check if a command was provided as an argument.
    if test -z "$argv[1]"
        echo "Usage: bkg <command> [arguments...]"
        return 1
    end

    # Run the command using nohup to make it immune to hangups (like closing the terminal).
    # Redirect both stdout and stderr to /dev/null to discard all output.
    # The final ampersand (&) sends the entire process to the background.
    nohup $argv &>/dev/null &
end