JOBS(1)

💖 NAME 💖

jobs — print currently running jobs.

okay bestie, welcome to the JOBS(1) page from fish-shell 🐟✨ — this is the fish builtin jobs, and she’s here to show you what’s currently running. main character energy fr fr 💅

✨ SYNOPSIS ✨

jobs [OPTIONS] [PID | %JOBID]

🦋 DESCRIPTION 🦋

⚠️ NOTE: this page documents the fish builtin jobs. Wanna see the documentation on any non-fish versions? Run command man jobs, bestie 🫶

jobs prints a list of the currently running jobs (#syntax-job-control) and their status. lowkey iconic.

jobs accepts the following options:

• -c, --command — prints the command name for each process in jobs.
• -g, --group — only prints the group ID of each job.
• -l, --last — prints only the last job to be started.
• -p, --pid — prints the process ID for each process in all jobs.
• -q, --query — prints no output; it’s for evaluation of jobs by exit status only. For compatibility with old fish versions this is also --quiet (but heads up: that one is deprecated 💀).
• -h, --help — displays help about using this command.

On systems that support this feature, jobs will print the CPU usage of each job since the last command was executed. The CPU usage is expressed as a percentage of full CPU activity. Note that on multiprocessor systems, the total activity may be more than 100% — yes, literally more than a hundo, no cap 🔥.

Arguments of the form PID or %JOBID restrict the output to jobs with the selected process identifiers or job numbers respectively. she’s selective like that 💅

If the output of jobs is redirected or if it is part of a command substitution, the column header that is usually printed is omitted, making it easier to parse. yes ma’am, built for the script girlies 🎀

The exit status of jobs is 0 if there are running background jobs and 1 otherwise. that’s the whole vibe check ✨

🌸 EXAMPLE 🌸

jobs outputs a summary of the current jobs, such as two long-running tasks in this example:

Job Group   State   Command
2   26012   running nc -l 55232 < /dev/random &
1   26011   running python tests/test_11.py &

🎀 Copyright 🎀

fish-shell developers

---

mwah 💋 — this page is fish-shell version 4.9, dated Sep 08, 2026, and it’s the JOBS(1) manual. byeee bestie 🫶✨