qbl

Run the qbl script with the task text as an argument and optionally add --why to record why it matters. The item is filed with the current repo, branch, and path automatically, so no manual context entry is needed.

It applies four criteria in order: items with open blockers are held, then ranked by how many items they unblock, then by whether they were filed on the current branch, then oldest first. The output states which criteria actually separated items and which did not.

Yes, the --shared flag pushes to a shared team queue instead of the local per-project file. It requires a collab-scoped token and an actor label; without them the command falls back to the local backlog and names the missing credential.

The command falls back to the local backlog, prints the connection failure reason, and exits with code 2 so scripts cannot mistake a partial answer for a complete one. A shared push that cannot land is refused entirely rather than silently filed locally.

There is no deduplication, so pushing the same text twice files it twice. Also, closing shared tasks is not supported from this command because only accepted tasks can transition to done, which requires the separate team handoff tool.