Released on June 3, 2026, cfgraft v0.2.0 brings a major evolution to how you manage your dotfiles. This release transforms the Terminal User Interface (TUI) from a simple viewer into a comprehensive management console, significantly streamlining the process of mapping and synchronizing your configuration files from Git to your local system.

What’s new

The centerpiece of v0.2.0 is a complete TUI overhaul designed for efficiency and responsiveness.

Integrated Mapping Management

You no longer need to manually edit config.yaml to manage your file mappings. The TUI now features integrated CRUD (Create, Read, Update, Delete) capabilities, allowing you to define, modify, and remove source-to-target path mappings directly through intuitive forms.

Intelligent Path Suggestions

To reduce errors and speed up configuration, cfgraft now assists you in defining paths:

  • Source Suggestions: The TUI walks your repository cache to suggest valid source files.
  • Target Suggestions: Local filesystem suggestions help you quickly identify the correct destination.
  • Real-time Validation: An instant [ok] or [x] indicator confirms whether a selected source path exists before you save the mapping.

Responsive Background Operations

Time-consuming tasks like sync, diff, and repository checkout no longer freeze your interface. These operations now run in the background, with a visual spinner providing feedback while the TUI remains fully responsive.

Refined User Experience

Several UX improvements make the tool more pleasant to use:

  • Improved Navigation: Smoother keyboard flow, including better focus management in the action bar.
  • Scrollable Viewports: Long sync and diff logs are now displayed in a scrollable window, ensuring no critical information is lost off-screen.
  • Safety Prompts: The tool now explicitly asks for confirmation before creating new parent directories for mapping targets.

Precision Bug Fixes

This release also improves the directory filter’s precision, ensuring that directories containing special characters (such as commas or spaces) are correctly identified and synchronized.

Why it matters

For users, these changes mean that cfgraft is no longer just a tool for executing syncs, but a complete environment for managing configuration state. By moving mapping management into the TUI and introducing background processing, the friction of maintaining complex dotfile setups is greatly reduced. The addition of real-time validation and intelligent suggestions minimizes the “trial and error” typically associated with configuring path mappings, making the entire experience more reliable and predictable.

Getting started with v0.2.0

Upgrading to v0.2.0 is seamless. There are no breaking changes to the config.yaml format, so your existing configurations will work perfectly.

Pre-compiled binaries are available for all major platforms:

  • macOS: darwin-amd64, darwin-arm64
  • Linux: linux-386, linux-amd64, linux-arm64
  • Windows: windows-386, windows-amd64

Whether you are a power user managing hundreds of config files or someone just starting with dotfile synchronization, v0.2.0 provides a more robust, responsive, and user-friendly way to keep your environment in sync.

This post was AI-generated using the model unsloth/gemma-4-31B-it-GGUF:UD-Q5_K_XL. It was generated on June 4, 2026, based on the cfgraft repository and the v0.2.0 release. Author: release-storyteller