# Install atomist-cli with Homebrew

Unified command-line tool for interacting with Atomist services. Version 1.8.0 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:atomist-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install atomist-cli
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:atomist-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/atomist-cli>
- **Version:** 1.8.0
- **Source summary:** Unified command-line tool for interacting with Atomist services
- **Homepage:** <https://github.com/atomist/cli>
- **Repository:** <https://github.com/atomist/cli>
- **Upstream docs:** <https://docs.atomist.com/>
- **License:** Apache-2.0
- **Source archive:** <https://registry.npmjs.org/@atomist/cli/-/cli-1.8.0.tgz>
- **Last updated:** 2026-06-22T14:02:47-07:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- @atomist (cli)
- atomist (cli)
- @atomist (alias)
- atomist (alias)

## Dependencies

- macos-term-size
- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, monterey, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.8.0
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://github.com/atomist/cli
- info: No cached GitHub release or tag data was available.
## Project history and usage

Atomist CLI is the command-line client for Atomist's software delivery automation platform. It connected local developer machines to Atomist services, workspaces, GraphQL schema fetching, Software Delivery Machine development, and Kubernetes helper workflows.

### Project history

The official README defines the Atomist CLI as a unified command-line tool for interacting with Atomist services. The package is a Node.js command distributed as the npm package @atomist/cli and, for macOS users, as the Homebrew formula atomist-cli.

The changelog shows an active 2018 to 2019 release train around the Atomist 1.0 milestone. Early versions added install messaging, Windows fixes, workspace login/configuration, Homebrew formula support, SDM-related commands, GraphQL schema fetching, and Kubernetes commands. Release 1.8.0 in September 2019 deprecated or removed some outdated commands while adding debug/dev flags and changing Kubernetes command naming.

### Adoption history

Adoption was tied to Atomist users rather than general Unix users. The README says users needed an Atomist workspace to interact with the Atomist API, and it points developers to Atomist's getting-started and developer prerequisites docs.

The CLI mattered most inside Atomist's ecosystem: configuring API keys and workspaces, starting local Software Delivery Machines, fetching GraphQL schema for API clients, and installing Kubernetes utilities into clusters. Homebrew support made it feel like a normal macOS developer tool even though its useful surface depended on Atomist's hosted services.

### How it is used

The README documents `atomist config` for local configuration, `atomist kube --environment=MY_CLUSTER` for Kubernetes utilities, `atomist gql-fetch` for downloading a workspace GraphQL schema, and `atomist --help` for command discovery.

The official source writes an API key and workspace IDs into the user configuration after validating the key and optionally creating one through an Atomist browser login flow. In practice, the CLI was a bootstrap and glue tool: install it, authenticate, connect a workspace, then use it to drive Atomist SDM and platform workflows.

### Why package nerds care

Atomist CLI is interesting to package nerds because it is a Homebrew-packaged Node CLI for a hosted developer automation service. The formula installed a local command, but the command's value came from remote Atomist APIs, which is a pattern common to modern DevOps CLIs.

Its changelog also captures a short, intense ecosystem period: milestone releases in 2018, rapid SemVer increments in 2019, and then little public release activity after the 1.8.x line. That makes it a snapshot of the Atomist SDM era rather than a broadly adopted general-purpose Unix utility.

### Timeline

- 2018: Early 0.6.x releases added install messaging and Windows command fixes.
- 2018-08: 1.0.0-M.1 aligned the CLI with Atomist 1.0 milestone dependencies.
- 2018-10: 1.0.0-RC.2 added Homebrew formula template and bash completion.
- 2018-12: 1.1.0 added login and config commands to connect to a workspace.
- 2019-03: 1.2.0 added SDM extension-pack install, provider/workspace creation, and Kubernetes SDM deployment changes.
- 2019-09: 1.8.0 added dev/debug flags, changed Kubernetes command naming, and removed or deprecated outdated commands.

### Related projects

- Related official Atomist projects include atomist/atomist-sdm, atomist/sdm-local, and @atomist/automation-client, which the CLI used to configure and run Software Delivery Machine workflows.

### Sources

- Official CHANGELOG.md.
- Official README.
- Official lib/config.ts.
- Official package.json.


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.atomist/client.config.json, ~/.atomist/client.config-${profile}.json

## Credential files

- Unix: ~/.atomist/client.config.json
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** atomist-cli
- **Version Scheme:** 0
- **Revision:** 1
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** yes
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [macos-term-size](https://www.automicvault.com/pkg/brew/macos-term-size/) - Runtime dependency declared by Homebrew.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [clive](https://www.automicvault.com/pkg/brew/clive/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [gh](https://www.automicvault.com/pkg/brew/gh/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [gptscript](https://www.automicvault.com/pkg/brew/gptscript/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [kagent](https://www.automicvault.com/pkg/brew/kagent/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [nanobot](https://www.automicvault.com/pkg/brew/nanobot/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [watchexec](https://www.automicvault.com/pkg/brew/watchexec/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [watchman](https://www.automicvault.com/pkg/brew/watchman/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [ahoy](https://www.automicvault.com/pkg/brew/ahoy/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [claude-hooks](https://www.automicvault.com/pkg/brew/claude-hooks/) - Both packages touch the same language runtime or ecosystem. Shared terms: automation, cli, developer, developer-tools, node.
- [graphql-cli](https://www.automicvault.com/pkg/brew/graphql-cli/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, command-line, developer, developer-tools, line.
- [gulp-cli](https://www.automicvault.com/pkg/brew/gulp-cli/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, command-line, developer, developer-tools, line.

## Combined YAML source

View the package source record on GitHub. [combined/atomist-cli.yml](https://github.com/automic-vault/db/blob/main/combined/atomist-cli.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
