# 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
- **Version:** 2026.07.23-e383d2b
- **Source summary:** Command-line agent for Cursor
- **Homepage:** <https://cursor.com/>
- **Last updated:** 2026-07-23T22:00:25Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

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

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2026.07.23-e383d2b
## 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
## 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


## Combined YAML source

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


## Sources

- pkg.so package database
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph