# Install cursor-cli with Homebrew Cask

Command-line agent for Cursor. Version 2026.07.23-e383d2b via Homebrew Cask; verified 2026-07-23. Also installable with nix: nix profile install nixpkgs#cursor-cli.

## Install

```sh
sudo av install cask:cursor-cli
```

Additional install commands:

### macOS

- Homebrew Cask (100%):

```sh
brew install --cask cursor-cli
```

  Evidence: local Homebrew cask metadata

## Package facts

- **Package key:** cask:cursor-cli
- **Package manager:** Homebrew Cask
- **Package manager page:** <https://formulae.brew.sh/cask/cursor-cli>
- **Version:** 2026.07.23-e383d2b
- **Source summary:** Command-line agent for Cursor
- **Homepage:** <https://cursor.com/>
- **Upstream docs:** <https://cursor.com/>
- **Source archive:** <https://downloads.cursor.com/lab/2026.07.23-e383d2b/darwin/arm64/agent-cli-package.tar.gz>
- **Last updated:** 2026-07-23T22:00:25Z
- **Generated:** 2026-07-25T07:20:51+00:00

## Executables

- cursor-agent (binary)
- cursor-agent (alias)

## Install behavior

- Post-install hook: not defined
- Bottle: not available

## Freshness

- Page generated: 2026-07-25
- Package-manager version: 2026.07.23-e383d2b
- Package-manager updated: 2026-07-23
- Local data: ok
- Upstream repository: https://cursor.com/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Cursor CLI is the command-line interface for Cursor Agent, letting developers interact with AI coding agents from a terminal for interactive work, scripts, and CI automation.

### Project history

Cursor's official CLI docs describe terminal-based agent sessions, non-interactive print mode, Cloud Agent handoff, resumable sessions, sandbox controls, and configuration through cli-config.json.

### Adoption history

The cask package turns Cursor's agent CLI into a package-manager-installable developer tool. That matters for teams standardizing AI coding tools across shells, CI jobs, and workstation bootstrap scripts.

### How it is used

Users install the CLI, authenticate with browser login or CURSOR_API_KEY, then run agent interactively or in print mode with prompts, models, and output formats. The config file stores CLI settings and permissions; API keys are supplied through environment variables or command flags.

### Why package nerds care

Cursor CLI is significant as a proprietary AI coding agent distributed like a Unix command: installable, scriptable, configurable, and usable headlessly.

### Timeline

- 2026: The Homebrew cask input records a dated packaged build, 2026.07.01-777f564.

### Related projects

- Cursor editor, Cursor Cloud Agent, MCP servers, and other terminal coding agents are adjacent tools.

### Sources

- <https://cursor.com/docs/cli/headless>
- <https://cursor.com/docs/cli/installation>
- <https://cursor.com/docs/cli/overview>
- <https://cursor.com/docs/cli/reference/authentication>
- <https://cursor.com/docs/cli/reference/configuration>
- source_facts.version


## Security Notes

No matching local secret-handling manifest was found for cursor-cli. Nucleus package metadata is still published here so future coverage has a stable package URL.



## 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: ~/.cursor/cli-config.json, .cursor/cli.json
- Windows: $env:USERPROFILE\.cursor\cli-config.json, .cursor\cli.json
## Source Database Details

- **Source Database:** Homebrew cask API
- **Tap:** homebrew/cask
- **Full Token:** cursor-cli
- **Names:** Cursor CLI
- **Artifacts:** Binary: 1, Target: 1, Zap: 1
- **Deprecated:** no
- **Disabled:** no

## Other Package-Manager Records

- Nix - cursor-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/cu/cursor-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Homebrew Cask packages](https://www.automicvault.com/pkg/homebrew-cask-packages/) - Generated from Homebrew Cask package-manager metadata.
- [Homebrew Cask binaries](https://www.automicvault.com/pkg/homebrew-cask-binaries/) - Cask artifact metadata includes a binary.

## Combined YAML source

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


## Sources

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