Skip to content

CLI

The desktop app and CLI use the same local Git workflow. Run commands from inside a Git repository, or pass --repo.

Common Commands

powershell
chunkymonkey status --repo .
chunkymonkey radar --repo . --threshold-mb 75
chunkymonkey plan --repo . --chunk-size 500mb --parts 2
chunkymonkey commit --repo . --chunk-size 500mb --parts 2 --message "Add assets"
chunkymonkey profile game --repo .
chunkymonkey repair --repo .

Updates

powershell
chunkymonkey update check --channel stable
chunkymonkey update check --channel dev
chunkymonkey update install --channel stable
chunkymonkey update install --channel dev

stable reads the latest public release. dev reads the newest public prerelease.

Help

text
usage: chunkymonkey [-h] [--version]
                    {status,doctor,radar,auth,auth-state,install-github-cli,github-login,github-switch,github-logout,github-orgs,github-repos,clone,create-repo,tree,stats,stage-status,stage,unstage,sync-status,history,run,plan,preview,commit,suggest-message,init,profile,ml-report,notebooks,ml-manifest,repro-snapshot,experiment-cleaner,repair,branches,create-branch,checkout,merge,rebase-onto,rename-branch,delete-branch,push-branch,checkout-commit,cherry-pick,revert,branch-at,reset-to,commit-details,commit-patch,compare-commit,stash-list,stash-apply,stash-pop,pop,stash-drop,stash-branch,conflict,pull,push,fetch,pull-rebase,stash,bug-report,diagnostics,update} ...

Git/LFS control for big repos.

positional arguments:
  {status,doctor,radar,auth,auth-state,install-github-cli,github-login,github-switch,github-logout,github-orgs,github-repos,clone,create-repo,tree,stats,stage-status,stage,unstage,sync-status,history,run,plan,preview,commit,suggest-message,init,profile,ml-report,notebooks,ml-manifest,repro-snapshot,experiment-cleaner,repair,branches,create-branch,checkout,merge,rebase-onto,rename-branch,delete-branch,push-branch,checkout-commit,cherry-pick,revert,branch-at,reset-to,commit-details,commit-patch,compare-commit,stash-list,stash-apply,stash-pop,pop,stash-drop,stash-branch,conflict,pull,push,fetch,pull-rebase,stash,bug-report,diagnostics,update}
    status              Show repo status.
    doctor              Check Git, LFS, remotes, and big changed files.
    radar               Find asset/LFS risk.
    auth                Check local Git/GitHub auth.
    auth-state          Show structured GitHub auth/account state.
    install-github-cli  Install GitHub CLI when the OS supports automation.
    github-login        Login a GitHub account through GitHub CLI.
    github-switch       Switch the active GitHub CLI account.
    github-logout       Logout GitHub CLI account.
    github-orgs         List accessible GitHub users/orgs.
    github-repos        List GitHub repos for active account or owner/org.
    clone               Clone a repo URL into a parent folder.
    create-repo         Create a GitHub repo under the active account or
                        owner/org.
    tree                Show changed files and tracked tree.
    stats               Show changed-file commit stats.
    stage-status        Show staged and unstaged files.
    stage               Stage paths, or all changes with --all.
    unstage             Unstage paths, or all staged files with --all.
    sync-status         Show upstream, conflict, and fast-forward safety
                        state.
    history             Show Git history.
    run                 Run a git command in the repo.
    plan (preview)      Preview commit chunks.
    commit              Commit chunks.
    suggest-message     Suggest a commit message from changed files.
    init                Apply .gitignore/.gitattributes templates.
    profile             Preview or apply workspace profile.
    ml-report           Audit ML/data/model artifacts, LFS state, notebooks,
                        and junk.
    notebooks           Audit or strip notebook outputs.
    ml-manifest         Preview or write ML_ARTIFACTS.md.
    repro-snapshot      Preview or write REPRO_SNAPSHOT.md.
    experiment-cleaner  Report or ignore common ML experiment junk.
    repair              Plan or apply safe repair.
    branches            List branches.
    create-branch       Create a branch and optionally check it out.
    checkout            Checkout branch if worktree is clean.
    merge               Merge a branch into the current branch.
    rebase-onto         Rebase current branch onto another branch.
    rename-branch       Rename a local branch.
    delete-branch       Delete a local branch.
    push-branch         Push a branch and set upstream.
    checkout-commit     Checkout a commit.
    cherry-pick         Cherry-pick a commit.
    revert              Revert a commit.
    branch-at           Create a branch at a commit.
    reset-to            Reset to a commit.
    commit-details      Show commit details.
    commit-patch        Show a commit patch.
    compare-commit      Compare commit to target ref.
    stash-list          List stashes.
    stash-apply         Apply a stash ref.
    stash-pop (pop)     Pop a stash ref or latest stash.
    stash-drop          Drop a stash ref.
    stash-branch        Create a branch from a stash.
    conflict            Inspect or control merge/rebase/cherry-pick conflicts.
    pull                Run git pull.
    push                Run git push.
    fetch               Run git fetch.
    pull-rebase         Run git pull-rebase.
    stash               Run git stash.
    bug-report          Open or create GitHub issue with diagnostics.
    diagnostics         Export diagnostics bundle.
    update              Check/install app updates.

options:
  -h, --help            show this help message and exit
  --version             Print app version.