crosvm-cl-tool
Skill to assist with using the `./tools/cl` tool for managing and uploading Gerrit CLs in the crosvm repository.
- License 许可
- BSD-3-Clause
- 所属仓库
- google/crosvm
- 最近更新
- 2026-11-14
- Stars
- ★ 1.4k
- Forks
- 191
01 前言 Front Matter
- name
- crosvm-cl-tool
- description
- Skill to assist with using the `./tools/cl` tool for managing and uploading Gerrit CLs in the crosvm repository.
03 SKILL.md 正文
Crosvm CL Tool (./tools/cl)
The ./tools/cl script is a custom tool in the crosvm repository used to manage local branches
and upload changes to the upstream Gerrit review site (https://chromium-review.googlesource.com).
It wraps git push with the correct Gerrit refs and options, and helps rebase changes when tracking
downstream branches.
Prerequisites
To use this tool, you must be on a local branch that tracks a remote branch (typically
origin/main). You can set this up when creating a branch:
git checkout -b mybranch --track origin/main
If you are already on a branch, you can set the upstream manually:
git branch --set-upstream-to origin/main
Subcommands
1. status
Lists all local branches, their tracking status, and the status of their local commits on Gerrit
(e.g., MERGED, ABANDONED, NEW, NOT_UPLOADED).
./tools/cl status
2. upload
Uploads local commits on the current branch to Gerrit.
./tools/cl upload [options]
Options:
-d,--dry-run: Show the push command that would be run without actually executing it.-r,--reviewer <email>: Add a reviewer. Can be repeated to add multiple reviewers.-a,--auto-submit: SetAuto-Submit+1andCommit-Queue+1labels on Gerrit.-s,--submit: SetCommit-Queue+2(trigger immediate submit after approval).-t,--try: SetCommit-Queue+1(trigger try jobs / dry run).
3. rebase
Helps rebase changes if you are tracking a different branch (e.g., aosp/main or cros/chromeos)
and want to upload to upstream origin/main.
It creates a new branch named <current-branch>-upstream tracking origin/main and cherry-picks
your local commits onto it.
./tools/cl rebase
Rebase Workflow:
- Run the rebase command:
./tools/cl rebase - If there are conflicts, resolve them manually:
# Resolve conflicts in files... git add <resolved-files> git cherry-pick --continue - Once the rebase/cherry-pick is complete, upload from the new
-upstreambranch:./tools/cl upload
4. prune
Cleans up your local repository by deleting local branches whose changes have already been merged or abandoned on Gerrit.
./tools/cl prune [options]
Options:
-f,--force: Force delete the branches without prompting for confirmation.
04 同仓库更多 Skills
crosvm-testing
Skill to assist with running tests and managing test VMs in the crosvm repository.
crosvm-dev-container
Skill to assist with using the `dev_container` tool for running builds, tests, and other tools in a consistent containerized environment.
crosvm-contribution-workflow
Skill to assist with the contribution workflow for crosvm. ALL agents making code changes MUST use this skill to run presubmit checks before committing.