CLI reference

Generated from que 0.2.0. To change it, edit que’s source in queapp-org/que.

Command	What it does
que daemon start [options]	start the daemon if it is not running
que daemon stop [options]	kill all terminals and stop the daemon
que daemon restart [options]	stop the daemon, ending every terminal, and start it from this build
que daemon status [options]	show whether the daemon is running
que daemon upgrade [options]	hand every terminal to the daemon of this que, without ending any
que daemon install [options]	install a launchd agent that keeps the daemon running
que daemon uninstall [options]	remove the launchd agent
que term list [options]	list terminals
que term new [options]	create a terminal running a login shell
que term snapshot [options] <id>	print the terminal screen and scrollback
que term kill [options] <id>	kill a terminal
que term attach [options] <id>	attach this TTY to a terminal (Ctrl-] detaches)
que project add [options] <path>	register a git repository
que project list [options]	list projects
que work [options] [brief]	create a workspace (git worktree) from a brief and print its path; the first line of the brief is its title, and its branch and folder get a random three-word name unless –name is given
que ws list [options]	list workspaces
que ws remove [options] <workspace>	remove a workspace: kill its terminals, run teardown, remove the worktree and delete its branch
que ws diff [options] <workspace>	what a workspace changed against its base, committed and uncommitted, with its commits
que ws files [options] <workspace>	every file of a workspace’s worktree, tracked and untracked, never ignored
que ws pr [options] <workspace>	a workspace’s pull request: its checks and its conversation
que ws terminal [options] <workspace>	print the id of the workspace’s latest live terminal, opening one if needed
que status [options]	summary and per-workspace status
que attach [options] <workspace>	attach to the workspace’s latest terminal, opening one if needed (Ctrl-] detaches)
que open [options] <workspace>	open the workspace with code -n
que tickets list [options]	list the cached tickets (the default)
que tickets sync [options]	fetch the queue from the tracker now
que tickets start [options] <key>	make a workspace for a ticket, write it as a brief, and start claude on it
que tickets open [options] <key>	open a ticket’s page in the browser
que unlock [options] [minutes]	unlock detail during quiet hours for a while (default: quiet_hours.unlock_minutes)
que lock [options]	end an unlock early
que quiet status [options]	whether quiet hours are on, until when, and any unlock
que quiet start [options] [minutes]	go quiet now, as in quiet hours, for a while (default 60 minutes, at most 720)
que quiet end [options]	end a manual quiet early
que config get [options]	print the config file path and the parsed config
que config set [options] <assignments...>	set keys (dotted, e.g. quiet_hours.default=19:00,07:00) and reload the daemon
que report [options]	the morning report: what the sessions did
que usage [options]	Claude plan usage: the five-hour and weekly windows, from the sessions’ status line
que hook [options]	report a Claude Code hook event (stdin JSON) to the daemon; used by hooks.json
que statusline [options]	report Claude plan usage (status line JSON on stdin) to the daemon, then run your own status line; used by hooks.json
que doctor [options]	check the daemon, claude, gh, git, node, config, and the hooks wrapper

Details

que daemon start

Usage: que daemon start [options]

start the daemon if it is not running

Options:
  -h, --help  display help for command

que daemon stop

Usage: que daemon stop [options]

kill all terminals and stop the daemon

Options:
  -h, --help  display help for command

que daemon restart

Usage: que daemon restart [options]

stop the daemon, ending every terminal, and start it from this build

Options:
  -h, --help  display help for command

que daemon status

Usage: que daemon status [options]

show whether the daemon is running

Options:
  --json      print JSON
  -h, --help  display help for command

que daemon upgrade

Usage: que daemon upgrade [options]

hand every terminal to the daemon of this que, without ending any

Options:
  --script <path>   daemon bundle to start (default: the one next to this CLI)
  --runtime <path>  program that runs it as Node (default: the one of this que)
  -h, --help        display help for command

que daemon install

Usage: que daemon install [options]

install a launchd agent that keeps the daemon running

Options:
  --no-load   write the agent without loading it
  -h, --help  display help for command

que daemon uninstall

Usage: que daemon uninstall [options]

remove the launchd agent

Options:
  --no-load   remove the file without unloading the agent
  -h, --help  display help for command

que term list

Usage: que term list [options]

list terminals

Options:
  --json      print JSON
  -h, --help  display help for command

que term new

Usage: que term new [options]

create a terminal running a login shell

Options:
  --cwd <dir>    working directory (default: the current directory)
  --name <name>  display name
  -h, --help     display help for command

que term snapshot

Usage: que term snapshot [options] <id>

print the terminal screen and scrollback

Options:
  --serialized  print the escape-sequence serialization instead of plain text
  -h, --help    display help for command

que term kill

Usage: que term kill [options] <id>

kill a terminal

Options:
  -h, --help  display help for command

que term attach

Usage: que term attach [options] <id>

attach this TTY to a terminal (Ctrl-] detaches)

Options:
  -h, --help  display help for command

que project add

Usage: que project add [options] <path>

register a git repository

Options:
  --name <name>  display name (defaults to the folder name)
  --json         print JSON
  -h, --help     display help for command

que project list

Usage: que project list [options]

list projects

Options:
  --json      print JSON
  -h, --help  display help for command

que work

Usage: que work [options] [brief]

create a workspace (git worktree) from a brief and print its path; the first
line of the brief is its title, and its branch and folder get a random
three-word name unless --name is given

Options:
  -r, --repo <repo>  repository path or configured repo name
  --name <name>      name the workspace, branch and folder yourself (default:
                     random words)
  --base <ref>       base ref (default: origin/<default branch>)
  --open             open the workspace with `code -n`
  --json             print the workspace as JSON
  -h, --help         display help for command

que ws list

Usage: que ws list [options]

list workspaces

Options:
  --project <project>  only this project (id, name, or path)
  --json               print JSON
  -h, --help           display help for command

que ws remove

Usage: que ws remove [options] <workspace>

remove a workspace: kill its terminals, run teardown, remove the worktree and
delete its branch

Options:
  --keep-branch  keep its branch
  -h, --help     display help for command

que ws diff

Usage: que ws diff [options] <workspace>

what a workspace changed against its base, committed and uncommitted, with its
commits

Options:
  --json          print JSON
  --base <ref>    compare against this ref instead of the default branch
  --commit <sha>  only that commit's own changes
  -h, --help      display help for command

que ws files

Usage: que ws files [options] <workspace>

every file of a workspace's worktree, tracked and untracked, never ignored

Options:
  --json      print JSON
  -h, --help  display help for command

que ws pr

Usage: que ws pr [options] <workspace>

a workspace's pull request: its checks and its conversation

Options:
  --json      print JSON ({ pr, thread })
  --refresh   check the pull request with GitHub and fetch its conversation
              again
  -h, --help  display help for command

que ws terminal

Usage: que ws terminal [options] <workspace>

print the id of the workspace's latest live terminal, opening one if needed

Options:
  --new       always open a new terminal
  -h, --help  display help for command

que status

Usage: que status [options]

summary and per-workspace status

Options:
  --json      print JSON
  -h, --help  display help for command

que attach

Usage: que attach [options] <workspace>

attach to the workspace's latest terminal, opening one if needed (Ctrl-]
detaches)

Options:
  -h, --help  display help for command

que open

Usage: que open [options] <workspace>

open the workspace with `code -n`

Options:
  -h, --help  display help for command

que tickets list

Usage: que tickets list [options]

list the cached tickets (the default)

Options:
  --json      print the tickets and sync state as JSON
  -h, --help  display help for command

que tickets sync

Usage: que tickets sync [options]

fetch the queue from the tracker now

Options:
  --json      print the tickets and sync state as JSON
  -h, --help  display help for command

que tickets start

Usage: que tickets start [options] <key>

make a workspace for a ticket, write it as a brief, and start claude on it

Options:
  -p, --project <project>  que project (name, path, or id) when not yet learned
  --session                a loose terminal in your home directory instead of a
                           workspace
  -h, --help               display help for command

que tickets open

Usage: que tickets open [options] <key>

open a ticket's page in the browser

Options:
  -h, --help  display help for command

que unlock

Usage: que unlock [options] [minutes]

unlock detail during quiet hours for a while (default:
quiet_hours.unlock_minutes)

Options:
  --why <text>  why, for the unlock log
  --json        print the quiet state as JSON
  -h, --help    display help for command

que lock

Usage: que lock [options]

end an unlock early

Options:
  --json      print the quiet state as JSON
  -h, --help  display help for command

que quiet status

Usage: que quiet status [options]

whether quiet hours are on, until when, and any unlock

Options:
  --json      print JSON
  -h, --help  display help for command

que quiet start

Usage: que quiet start [options] [minutes]

go quiet now, as in quiet hours, for a while (default 60 minutes, at most 720)

Options:
  --json      print the quiet state as JSON
  -h, --help  display help for command

que quiet end

Usage: que quiet end [options]

end a manual quiet early

Options:
  --json      print the quiet state as JSON
  -h, --help  display help for command

que config get

Usage: que config get [options]

print the config file path and the parsed config

Options:
  --json      print JSON
  -h, --help  display help for command

que config set

Usage: que config set [options] <assignments...>

set keys (dotted, e.g. quiet_hours.default=19:00,07:00) and reload the daemon

Options:
  --apply-tonight  let a change that shortens tonight's quiet hours apply now
  --json           print the result as JSON
  -h, --help       display help for command

que report

Usage: que report [options]

the morning report: what the sessions did

Options:
  --since <when>  ISO time or a duration back from now (12h, 90m, 2d)
  --json          print JSON
  -h, --help      display help for command

que usage

Usage: que usage [options]

Claude plan usage: the five-hour and weekly windows, from the sessions' status
line

Options:
  --json      print JSON (null before the first reading)
  -h, --help  display help for command

que hook

Usage: que hook [options]

report a Claude Code hook event (stdin JSON) to the daemon; used by hooks.json

Options:
  -h, --help  display help for command

que statusline

Usage: que statusline [options]

report Claude plan usage (status line JSON on stdin) to the daemon, then run
your own status line; used by hooks.json

Options:
  -h, --help  display help for command

que doctor

Usage: que doctor [options]

check the daemon, claude, gh, git, node, config, and the hooks wrapper

Options:
  -h, --help  display help for command