The official Homebrew tap for the Atomic CLI — a mathematically sound distributed version control system built for AI-assisted development.
brew tap atomicdotdev/tap
brew install atomicOr in one line:
brew install atomicdotdev/tap/atomicbrew upgrade atomicdotdev/tap/atomicAfter installation, brew upgrade atomic also works in normal Homebrew setups.
atomic --versionTo exercise the installed Node-API library as well (Node is a test-only dependency):
brew install --only-dependencies --include-test atomicdotdev/tap/atomic
brew test atomicdotdev/tap/atomicA binary build of the Atomic CLI, downloaded from the official GitHub release. Native runtime availability follows the upstream release targets:
| OS | Architecture | Node-API runtime |
|---|---|---|
| macOS | Apple Silicon (aarch64) | Included |
| macOS | Intel (x86_64) | CLI only |
| Linux | x86_64 | Included |
| Linux | aarch64 | CLI only |
On native-runtime platforms, the formula installs atomic, the platform library
(libatomic.dylib or libatomic.so), and libatomic-runtime.json together under
libexec. The public bin/atomic is a symlink to that executable. nodeatomic
follows the symlink and discovers the adjacent library and manifest; no library
is built or downloaded separately. A missing or inconsistent runtime bundle
fails installation rather than silently installing only the CLI on these hosts.
Homebrew can rewrite library linkage and re-sign Mach-O binaries. The formula refreshes the manifest's library checksum after that processing, while retaining the release's protobuf descriptor fingerprint. The formula test loads the library in Node and checks that fingerprint against the actual exported descriptor.
The installed runtime must match the protobuf contract expected by its consumer, including Atomic Sherpa. Installing a complete older runtime does not make it compatible with a newer consumer. A matching runtime release is still required.
The current complete-runtime formula targets Atomic v0.22.0. It retains formula revision 1 so existing CLI-only v0.22.0 installations upgrade to the complete runtime layout.
Ensure the Homebrew atomic is the active executable (type -a atomic). An
explicit runtime override or a runtime registered by another installer takes
precedence over PATH discovery. To select this installation explicitly on a
supported native-runtime platform, set the following before launching the editor:
export ATOMIC_RUNTIME_DIR="$(brew --prefix atomicdotdev/tap/atomic)/libexec"Unset any conflicting LIBATOMIC_ADDON override. GUI-launched editors may not
inherit shell exports; configure the extension-host environment accordingly.
For Windows, download the .zip directly from the release page.
If you don't use Homebrew:
curl -sSf https://atomic.storage/install.sh | shSee the Atomic installation docs for all options.
nodeatomic and Atomic Sherpa require a matching native library and runtime manifest, not just the CLI. Verify that an alternative installation provides the complete runtime before using those consumers.
Formula/atomic.rb is kept at the latest release automatically: the
Update formula workflow runs daily,
reads the newest atomic release
and its checksums-sha256.txt, and commits the new version and hashes when
they differ. No secrets are involved — the release is public and the workflow
commits with its own token.
Installation-layout fixes use a formula revision so existing installations upgrade even when the upstream version is unchanged. The updater preserves that revision for same-version updates and removes it when moving to a new upstream version.
The Test tap workflow runs updater regressions and
installs/tests the formula on macOS and Linux, using
Homebrew/actions/setup-homebrew@main to prepare the test environment.
To run the updater regressions locally with Minitest installed:
ruby scripts/update_formula_test.rbTo pick up a published formula update:
brew update
brew upgrade atomicdotdev/tap/atomicor trigger the workflow directly from the Actions tab.
For issues with the Atomic CLI itself, open an issue at atomicdotdev/atomic.
For issues specific to this tap (formula errors, install failures via brew), open an issue here.
The tap formula is dual-licensed under MIT and Apache-2.0, matching the Atomic CLI itself.