# Install droid with Homebrew Cask

AI-powered software engineering agent by Factory. Version 0.187.0 via Homebrew Cask; verified 2026-08-04.

## Install

```sh
sudo av install cask:droid
```

Additional install commands:

### macOS

- Homebrew Cask (100%):

```sh
brew install --cask droid
```

  Evidence: local Homebrew cask metadata

## Package facts

- **Package key:** cask:droid
- **Package manager:** Homebrew Cask
- **Package manager page:** <https://formulae.brew.sh/cask/droid>
- **Version:** 0.187.0
- **Source summary:** AI-powered software engineering agent by Factory
- **Homepage:** <https://docs.factory.ai/cli/getting-started/overview>
- **Upstream docs:** <https://docs.factory.ai/cli/getting-started/overview>
- **Source archive:** <https://downloads.factory.ai/factory-cli/releases/0.186.0/darwin/arm64/droid>
- **Last updated:** 2026-08-04T01:15:04Z
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- droid (binary)
- droid (alias)

## Dependencies

- ripgrep

## Install behavior

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

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 0.187.0
- Package-manager updated: 2026-08-04
- Local data: ok
- Upstream repository: https://docs.factory.ai/cli/getting-started/overview
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Droid CLI is Factory's terminal software-engineering agent, distributed through installer scripts, npm, and the Homebrew cask named droid.

### Project history

Factory's public repository was created in September 2025 and presents Factory as an agent-native development platform spanning CLI, web, Slack/Teams, Linear/Jira, and mobile. Official docs describe droid as Factory's development agent in the terminal.

### Adoption history

The official quickstart lists macOS/Linux shell install, Windows PowerShell install, npm install, and Homebrew cask installation. That multi-channel distribution reflects the current AI coding-agent pattern: meet developers in existing terminals and code repositories, then sync with team systems.

### How it is used

Users install droid, run it from a project directory, and interact through a full-screen terminal UI. The docs cover codebase analysis, proposed code changes, approvals, security audits, version-control help, slash commands, settings, model selection, sessions, missions, MCP, hooks, plugins, and skills.

### Why package nerds care

As a package, Droid is notable because it packages a cloud-connected AI development agent as a familiar terminal binary. Its settings file, local overrides, Homebrew cask, npm package, and direct binary download put a fast-moving AI tool into the same operational lane as classic developer CLIs.

### Timeline

- 2025: Public Factory repository created.
- 2025: Repository copyright range begins for Factory AI.
- 2026: Homebrew cask distributes Droid CLI release binaries.

### Related projects

- Factory's TypeScript and Python SDKs are linked from the official repository.
- Droid Action is the GitHub Actions integration for reviews, scans, and PR descriptions.
- Factory plugins, MCP integrations, custom droids, hooks, and skills are documented extension surfaces.

### Sources

- <https://github.com/Factory-AI/factory>
- <https://raw.githubusercontent.com/Factory-AI/factory/main/README.md>
- <https://docs.factory.ai/cli/getting-started/overview>
- <https://docs.factory.ai/cli/getting-started/overview.md>
- <https://docs.factory.ai/cli/getting-started/quickstart.md>
- <https://docs.factory.ai/cli/configuration/settings.md>
- <https://formulae.brew.sh/cask/droid>
- <https://formulae.brew.sh/api/cask/droid.json>


## Security Notes

No matching local secret-handling manifest was found for droid. 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: ~/.factory/settings.json
- Windows: %USERPROFILE%\.factory\settings.json
## Source Database Details

- **Source Database:** Homebrew cask API
- **Tap:** homebrew/cask
- **Full Token:** droid
- **Names:** Droid
- **Depends On:** Formula: ripgrep
- **Artifacts:** Binary: 1, Target: 1, Zap: 1
- **Auto Updates:** yes
- **Deprecated:** no
- **Disabled:** no


## Related links

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

## Combined YAML source

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


## Sources

- pkg.so package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph