CLI Reference

CLI Reference

The CLI installs as scholion with the short alias av (the same program). It is a thin HTTP client of the daemon and finds its task through the nearest .av-task file in the workspace. AV_URL, AV_SESSION, AV_AGENT (or --agent) and AV_TOKEN override the defaults.

This page lists the common commands; av --help and av <command> --help show every flag.

Daemon and repos

av up                               # start the lite-mode daemon
av down                             # stop it
av init [--name NAME] [--for claude|codex|grok|gemini|cursor|mcp-json]...
av repo add NAME PATH               # import a git repo
av repo list                        # every imported repo, its main and source
av repo settings NAME --check "python -m pytest -q"
av repo backup NAME --remote URL [--branch av-main]
av reindex [--repo NAME]            # rebuild the code index and vectors
av status

Working a task

av task start --repo R --title T --goal G
av checkpoint                       # snapshot + refresh the index
av record --kind decision|attempt|note --summary "..." --anchor path[:Symbol]
av context [--budget N] [--fresh]   # the context pack; --fresh resends everything
av expand ID                        # the full tier of one pack item
av search "rate limit"              # full-text over the repo's records
av validate ...                     # report a check you ran and its exit code
av submit                           # to review
av review ...                       # as a reviewer: approve or request changes
av merge                            # merge an approved task into main
av undo                             # take back the last merge of a task
av sync                             # bring the task up to date with main
av handoff --done "..." --remaining "..." [--needs TAGS]
AV_AGENT=codex av claim TASK        # another agent takes over; rewrites .av-task
av bundle --pr                      # review bundle: tests at head, risks, checklist
av log                              # main's history, newest first
av abandon                          # end a task for good (owner only)

Read without a checkout

av show PATH
av diff
av why app/util.py:42 --repo R      # the task, goal and decisions behind a line
av events --follow                  # lifecycle event feed

Many agents

av agent set NAME --best TAGS --can TAGS --cost N [--max-open N] [--alias A]
av agent list
av post --repo R --title T --goal G [--needs TAGS] [--prefer NAME] [--after ITEM]
av backlog
av next [--wait 50] [--take review,merge,work]
av --agent NAME watch [--every SECS] -- CMD...

See Multi-Agent Routing.

After a merge

av runner --repo R --trust
av health --repo R
av bisect --repo R --trust
av revert TASK --reason "..."

See Post-Merge Checks.