Reference: Other

Reference for the "Other" group of qargi commands: every verb with its arguments, options and examples, generated from the release.

Updated 2026-11-05

qargi upgrade #

Move the installed tool to a newer branch or tag of its origin.

Works on the root-owned checkout install.sh recorded (for example /opt/qargi). Without --approved it fetches the target, shows the commits and files that would change and prints a plan token. With --plan TOKEN --approved "..." it applies exactly that: a branch on the current branch moves forward only (fast-forward), another branch is checked out at its tip, a tag is checked out detached; install.sh --user then runs as you and the members to refresh are listed. The git commands that write into the checkout run through sudo (QARGI_SUDO names another command). When the members file (~/.qargi/config/agents.json) is not in the current shape, which every agent verb refuses, the plan and the end of the upgrade say so and how to redo it; nothing is changed for that. A member or agent cannot use it.

qargi upgrade [OPTIONS]

Option	Argument	What it does
`--branch`	`BRANCH`	the branch to move to (default: the installed checkout's current branch)
`--tag`	`TAG`	a tag to check out instead
`--plan`	`TOKEN`	the plan token printed by the same command without --approved
`--approved`	`WORDS`	your go-ahead for exactly that plan, in your words; recorded in the audit log

qargi upgrade --branch develop
qargi upgrade --branch develop --plan 1a2b3c4d5e6f --approved "upgrade to develop"
qargi upgrade --tag v0.2.0

qargi help #

Show help.

qargi help shows the commands; qargi help COMMAND the verbs and options of one; qargi help TOPIC explains an idea. Every command also takes --help.

qargi help [COMMAND|TOPIC] [OPTIONS]

Option	Argument	What it does
`--man`		print the manual page source (roff); view it with: qargi help --man \| man -l -

qargi version #

Print the version.

qargi version