---
id: b12b0403-81a7-40c9-9d8e-7a1654d7a800
title: '--json placement: trailing per-command (gh-literal); usage lines lied'
state: closed
labels: []
assignees: []
milestone: null
created: 2026-09-08T07:44:29Z
updated: 2026-09-08T08:14:39Z
---
SOURCE: swarm friction #2 (verified: `f0rge --json issue list` =
human format, flag eaten by root; `f0rge issue list --json` works).
gh-literal: --json/--jq are per-command TRAILING; root only routes
--skill. FIX docs (truth, not code): root help usage line
"f0rge [--json|--jq E|--skill] <cmd> [args]"
-> "f0rge [--skill] <cmd> [--json|--jq E] [args]"; skill usage line
"[--json] <cmd> [args]" -> "<cmd> [--json] [args]" (byte-neutral);
every verb -h usage line says trailing. Optional (not now): thread
leading --json through. DONE: every usage line truthful;
`f0rge --json issue list` being human is no longer claimed anywhere.