# Install advai-cli with Homebrew

CLI for managing skills and external CLIs. Version 1.0.12 via Homebrew; verified 2026-07-23.

## Install

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

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install advai-cli
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:advai-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/advai-cli>
- **Version:** 1.0.12
- **Source summary:** CLI for managing skills and external CLIs
- **Homepage:** <https://github.com/Advai-X/advai-cli>
- **Repository:** <https://github.com/Advai-X/advai-cli>
- **Upstream docs:** <https://github.com/Advai-X/advai-cli#readme>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/ca/2c/4e7e64f2c6895555a5cf6cc4b7fd030d1b265f77969d1f417cfd84bd802e/advai_cli-1.0.12.tar.gz>
- **Last updated:** 2026-07-23T06:34:23Z
- **Generated:** 2026-07-25T07:20:51+00:00

## Executables

- advai (cli)
- advai (alias)

## Dependencies

- python@3.14

## Install behavior

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

## Freshness

- Page generated: 2026-07-25
- Package-manager version: 1.0.12
- Package-manager updated: 2026-07-23
- Local data: ok
- Upstream repository: https://github.com/Advai-X/advai-cli
- info: No cached GitHub release or tag data was available.
## Project history and usage

advai-cli is a Python-first command-line tool that combines local agent-skill management, browser automation, external-CLI integration, local knowledge bases, and terminal chat against OpenAI-compatible APIs behind the `advai` command. Its maintainers distribute the same implementation through PyPI, npm, and Homebrew.

### Project history

The official GitHub repository was created in June 2026. Public Python and npm packages followed within days, and the project advanced through several 1.0.x releases by early July 2026. The implementation remains deliberately local-first, with runtime state under `~/.advai` and a small Python core built around Click and aiohttp.

### Adoption history

The project adopted a multi-ecosystem packaging model at launch: PyPI carries the Python implementation, the npm package creates a private Python environment and installs the matching PyPI version, and Homebrew installs the package in a formula-managed virtual environment. Homebrew's official formula listed version 1.0.9 and reported 36 installs in its first 30-day analytics window as of July 2026, indicating early rather than mature adoption.

### How it is used

Typical use begins with `advai info`, then branches into `advai skill` for installing and synchronizing skills, `advai browser` for Chrome-extension-backed automation, `advai cli` for OpenCLI-backed external commands, `advai kb` for local document collections, or `advai tui` for terminal chat. AI access is configured through `ADVAI_*` variables, with selected `OPENAI_*` variables accepted as fallbacks; the API key is supplied through the environment rather than a documented credentials file.

### Why package nerds care

The package is notable for presenting one CLI through three package-manager cultures without maintaining three independent implementations. Its npm artifact is a launcher and environment bootstrap around the Python distribution, while Homebrew also provisions the Python package into an isolated environment. That arrangement makes version alignment, install provenance, and update behavior visible parts of the tool's design.

### Timeline

- 2026-06-19: Official GitHub repository created.
- 2026-06-21: First currently listed PyPI releases and the initial npm publication appeared.
- 2026-07-05: Version 1.0.9 was published to PyPI, npm, and GitHub Releases.
- 2026-07: Homebrew distributed version 1.0.9 as bottled packages for supported macOS and Linux systems.

### Related projects

- OpenCLI supplies advai-cli's external-CLI discovery, registration, and passthrough layer.
- OpenAI-compatible chat-completions APIs provide the backend interface used by the terminal chat UI.
- Agent hosts such as Codex, Claude Code, Cursor, and Gemini CLI are among the platforms to which advai-cli can synchronize installed skills.

### Sources

- Official GitHub releases: https://github.com/Advai-X/advai-cli/releases
- Official Homebrew formula and analytics: https://formulae.brew.sh/formula/advai-cli
- Official PyPI project and release history: https://pypi.org/project/advai-cli/
- Official npm registry metadata: https://registry.npmjs.org/advai-cli
- Official repository and README: https://github.com/Advai-X/advai-cli


## Security Notes

No matching local secret-handling manifest was found for advai-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: ~/.advai/skill_platforms.json
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** advai-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **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.
- [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [AI and agent packages](https://www.automicvault.com/pkg/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [gptscript](https://www.automicvault.com/pkg/brew/gptscript/) - Shares av.db curated category or tags: ai, cli, developer-tools, orchestration.
- [kagent](https://www.automicvault.com/pkg/brew/kagent/) - Shares av.db curated category or tags: ai, cli, developer-tools, orchestration.
- [nanobot](https://www.automicvault.com/pkg/brew/nanobot/) - Shares av.db curated category or tags: ai, cli, developer-tools, orchestration.
- [aoe](https://www.automicvault.com/pkg/brew/aoe/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [cc-connect](https://www.automicvault.com/pkg/brew/cc-connect/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [cc-switch-cli](https://www.automicvault.com/pkg/brew/cc-switch-cli/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [claude-squad](https://www.automicvault.com/pkg/brew/claude-squad/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [dstack](https://www.automicvault.com/pkg/brew/dstack/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [mistral-vibe](https://www.automicvault.com/pkg/brew/mistral-vibe/) - Both packages touch the same language runtime or ecosystem. Shared terms: agent, ai, cli, developer, developer-tools.
- [langgraph-cli](https://www.automicvault.com/pkg/brew/langgraph-cli/) - Both packages touch the same language runtime or ecosystem. Shared terms: ai, cli, orchestration, python, python-3-14.
- [rapid-mlx](https://www.automicvault.com/pkg/brew/rapid-mlx/) - Both packages touch the same language runtime or ecosystem. Shared terms: ai, cli, compatible, openai, openai-compatible.

## Combined YAML source

View the package source record on GitHub. [combined/advai-cli.yml](https://github.com/automic-vault/db/blob/main/combined/advai-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
- cross-ecosystem install command graph
