Skip to content

Changelog ​

The command-line tool (the yunbox npm package) and the macOS app share one version number. The notes for a new version also appear in the app's update prompt. 简体中文

Unreleased ​

0.1.11 - 2026-10-27 ​

Added ​

  • Push protection can show a confirmation for every push, including those within budget. Enable it through the CLI, Git configuration, or macOS Setup Assistant; decisions are saved in local history.

Changed ​

  • Push reports distinguish the compressed, delta-encoded Git upload estimate from raw file content and before/after size changes.

Fixed ​

  • When an existing remote branch's base commit is missing locally, inspection asks you to fetch before checking instead of showing misleading upload sizes. Ordinary file changes on new branches are no longer incorrectly marked as additions by full LFS history.

0.1.10 - 2026-10-25 ​

Added ​

  • Push protection gains local compatibility mode for Husky and custom project hooks. Original checks and uploads run only after YunBox passes, with repair for overridden protection, configuration restoration, and missing-directory diagnostics.
  • macOS shows global enablement separately from effective repository protection and coverage of known repositories, with actions to connect, repair, and restore hooks.

0.1.9 - 2026-10-25 ​

Changed ​

  • The macOS over-budget confirmation opens faster, showing the destination, exceeded budgets and decision buttons before loading the file list. Diffs remain on demand, and closing the confirmation window cancels the push.

0.1.8 - 2026-10-25 ​

Changed ​

  • The macOS over-budget confirmation opens without waiting for every file's diff preview. Diffs are generated on demand, reused on repeated views, and cancelled when the dialog closes.

0.1.7 - 2026-10-25 ​

Added ​

  • Push protection keeps a per-project history of timestamps, reasons, cancellations and confirmed continuations, including user notes. Browse by project in the app and clear one project or all local history. Records are retained for 90 days, up to 200 per project.

0.1.6 - 2026-10-24 ​

Added ​

  • The repository now has complete Chinese and English READMEs with WebP promotional banners and real app screenshots, making installation, push inspection and storage setup easier to find.
  • The macOS app now guides first-time setup: check tools, choose a repository, enable push protection, and optionally connect asset storage. Reopen the guide from Help or Settings.
  • Push protection supports optional global installation and removal, preserves repository hooks, and reports which protection is effective.
  • The homepage now features the promo video: click the airport cover to play P1, or watch all three versions on Bilibili.
  • Windows can confirm over-budget pushes in the console, with an optional reason for continuing or cancelling. On macOS, choose graphical or terminal confirmation per repository or globally.
  • Expandable FAQs cover asset storage, collaborator setup, cross-platform terminal confirmation and color settings.

Changed ​

  • Repository initialization now offers push protection. Newly installed hooks ask before an over-budget push and work with the app closed; setup can skip protection or use immediate blocking.
  • The macOS file list distinguishes changes with colors and symbols, identifies asset types with icons, emphasizes filenames over folders, and highlights files over budget while staying readable in dark mode and selected rows.
  • The macOS app now requires macOS 26 or later. Command-line platform support is unchanged.
  • The macOS sidebar uses native icon and label layout and selection styling, showing parent folders only to distinguish repositories with the same name. Inline shortcut hints are removed; ⌘1–⌘9 still switch repositories and remain visible in the menu.
  • Terminal push reports consistently show code and asset destinations, upload sizes and skipped objects. Status, diagnostics and setup steps highlight key information with color; pipes, CI and JSON remain plain, and NO_COLOR=1 disables color.

Fixed ​

  • On Windows, push protection now continues after a successful check when the repository had no pre-push hook, instead of trying to run a missing original hook.
  • GitHub release notes refresh when the release workflow is rerun, with Chinese and English descriptions and a full version comparison link.
  • Reinitializing a protected repository or adding Git LFS afterward preserves its upload hooks.
  • Fixed local app builds sometimes showing older sidebar and control styling, keeping previews consistent with release builds.
  • yunbox status now shows direct COS / S3 storage and agent registration correctly instead of treating a missing lfs.url as missing setup. New clones receive instructions when their agent has not been configured.

0.1.5 - 2026-10-23 ​

Added ​

  • The macOS app updates itself: it checks once a day in the background, or on demand from YunBox → Check for Updates…; updates and their notes are verified by signature.
  • The macOS app is available in Simplified Chinese and English. Pick the language in Settings → Language, or follow the system.
  • A changelog page, which the app opens from the Help menu and from Settings → Software Update.
  • Push freeze: yunbox freeze sets weekly windows when pushing is not allowed (working hours, for example), and pre-push blocks pushes inside them. Rules can apply to one repository, the whole team, or every repository on the Mac.
  • yunbox freeze off switches push freezes off for a while or until a given time, and they come back on by themselves.
  • The macOS app shows in the menu bar whether the current repository can push, with today's and the next 7 days' freeze windows, one-click presets and a quick off switch.
  • The macOS app's COS panel copies a setup prompt for AI coding assistants.
  • git yunbox types manages LFS rules by asset type: it shows whether each type goes through LFS and how many files it has, and lists assets committed as ordinary files (including extensions in a different case on Linux, such as HERO.PNG). add adds types, with --renormalize to store already-committed files in LFS from the next commit on; remove deletes only the rules YunBox generated. --json is for graphical tools.
  • Presets pick common sets of asset types at once: game, design, media and all, also accepted by git yunbox init --types.
  • The macOS app has an Asset Types panel: see whether each kind of asset goes through LFS and how many files it has, add a preset in one click, add or remove single types, and move assets committed as ordinary files to LFS from the next commit on (after a confirmation; history stays as it is).
  • The website is now available in English: the homepage, every guide and the push check reference, with a language switcher. The macOS app opens the English docs when its interface is in English.
  • When pre-push blocks a push (a push freeze, an exceeded budget, or Cancel in the confirmation), YunBox notes on this Mac which repository it was, when and why. The macOS app's sidebar has a new Recently Blocked section that lists them; click one to open and check it.
  • S3-compatible storage such as Cloudflare R2, AWS S3 and MinIO: connect a repository with git yunbox init --preset r2 (or aws, minio, --endpoint) and save keys with yunbox login --provider s3; pushing, cloning, doctor and the push check work as they do with COS. R2 tokens can be limited to buckets but not to prefixes, so use one bucket per project; see the new guide on R2 and S3-compatible storage.
  • The push confirmation dialog takes an optional reason for cancelling or going ahead, and on the terminal a reason can follow y / n. It shows in the push output, so whoever started the push, or the AI coding assistant that did, knows why and what to do next; a cancel reason also shows under Recently Blocked.
  • The macOS app's COS panel is now a Storage panel that also handles S3-compatible storage such as R2, AWS S3 and MinIO: the header shows which storage the repository uses (for example "Direct R2 · OK"), and you can pick a provider and connect in one click, save S3 keys, and copy an AI setup prompt written for that storage.
  • A new guide, “Migrating from GitHub LFS”, shows how to move every past version of your assets from GitHub LFS or another LFS service to your own COS bucket, check the result, switch collaborators over and roll back.
  • The macOS app's Recent Repositories now lists the repositories you used from the command line (for example ones you ran git yunbox init in, or pushed from with the pre-push check), so you no longer have to open each one in the app first.
  • Pin the repositories you use most in the macOS app: right-click → Pin moves one to the Pinned section at the top of the sidebar, where new repositories never push it out and Clear Recents leaves it alone; drag to reorder. ⌘1–⌘9 go to pinned repositories first.
  • The macOS app’s menu bar icon tips its lid open while the panel is showing and closes it again afterwards, and the dot pops in when a push freeze starts. With Reduce Motion on, there is no animation. Changes from the refresh when the panel opens now ease in instead of jumping.

Changed ​

  • The macOS app is notarized by Apple, so it opens the first time without a trip to Privacy & Security.
  • The website and documentation are now available at yunbox.yunle.fun.
  • Budgets in the macOS app are now edited as a number and a unit, with common values and Restore Default. After changing them you can check the current repository again right away, and when the app follows Git config it shows the budgets the last check actually used.
  • In repositories connected directly to COS, the push check first asks COS which LFS assets are already there and budgets only what actually needs uploading, so a new branch is no longer flagged for assets the remote already has. If the lookup fails or times out, it counts every asset as before and never blocks the push.
  • The buttons at the top of the push confirmation dialog show the icon of the app they open (Finder, your editor, YunBox, your default browser), so they are easier to tell apart at a glance.

Fixed ​

  • Fix direct transfers on Windows when the CLI is not installed globally: the transfer agent now starts correctly from its absolute path.
  • The macOS client uses its bundled transfer agent when connecting storage, preventing an older command-line installation from breaking S3 pushes.
  • The macOS Storage panel refreshes setup after saving COS keys. Restricted accounts that cannot list buckets can connect an existing bucket without being asked to create one.
  • Fixed intermittent missing-icon errors that prevented the macOS app from being packaged when building from source.
  • Fixed closed connections that prevented the website and documentation from opening on some networks.
  • git yunbox init no longer adds LFS rules for file types that already have files committed outside LFS, so those files no longer show up as modified or break new clones. It lists them and shows the commands to move them to LFS.
  • The file preview opened from the push confirmation for exceeded budgets now closes with its close button or Esc. While a preview is open, Esc closes it instead of cancelling the push.

0.1.4 - 2026-10-19 ​

Added ​

  • The push confirmation previews the changed files, with a line-by-line diff for text files.
  • The macOS app compares the selected file before and after the push, with unified and side-by-side text diffs.

0.1.3 - 2026-10-19 ​

Added ​

  • A push over budget lists every file and asks you to confirm.
  • The documentation is now a VitePress website with downloads.

Changed ​

  • Shared team settings moved to .yunbox/config; the old .yunboxconfig is still read, and yunbox doctor prints the command to move it.

0.1.2 - 2026-10-19 ​

Added ​

  • yunbox subaccount creates long-term sub-account keys with only the permissions they need, and saves them on this machine, in one command.

0.1.1 - 2026-10-19 ​

Fixed ​

  • git yunbox init exits normally when it has nothing to ask, instead of hanging the terminal.
  • On Windows, git-lfs starts the transfer agent correctly, and yunbox hook install works.

0.1.0 - 2026-10-19 ​

Added ​

  • First public release: Git LFS assets upload straight to your own Tencent Cloud COS, with no server in between.
  • The git yunbox init, doctor, status, login and policy commands; on macOS, keys are kept in the keychain.
  • A pre-push check of Git and LFS upload sizes.
  • The macOS app: inspect push sizes, see the direct COS status and set it up from the window.

Released under the MIT License