# 使用 Homebrew 安装 advai-cli

查看 advai-cli 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

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

其他安装命令:

### macOS

- Homebrew (100%):

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

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:advai-cli
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/advai-cli>
- **版本:** 1.0.12
- **来源摘要:** CLI for managing skills and external CLIs
- **主页:** <https://github.com/Advai-X/advai-cli>
- **仓库:** <https://github.com/Advai-X/advai-cli>
- **上游文档:** <https://github.com/Advai-X/advai-cli#readme>
- **许可证:** MIT
- **源码归档:** <https://files.pythonhosted.org/packages/ca/2c/4e7e64f2c6895555a5cf6cc4b7fd030d1b265f77969d1f417cfd84bd802e/advai_cli-1.0.12.tar.gz>
- **最后更新:** 2026-07-23T06:34:23Z
- **已生成:** 2026-07-25T07:20:51+00:00

## 可执行文件

- advai (cli)
- advai (别名)

## 依赖

- python@3.14

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-25
- 管理器版本: 1.0.12
- 管理器更新时间: 2026-07-23
- 本地数据: OK
- 上游仓库: https://github.com/Advai-X/advai-cli
- 信息: No cached GitHub release or tag data was available.
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- 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


## 安全说明

没有找到 advai-cli 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 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:** 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


## 相关链接

- [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family.
- [MCP tool packages](https://www.automicvault.com/zh-hans/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [AI and agent packages](https://www.automicvault.com/zh-hans/pkg/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [python@3.14](https://www.automicvault.com/zh-hans/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [gptscript](https://www.automicvault.com/zh-hans/pkg/brew/gptscript/) - Shares av.db curated category or tags: ai, cli, developer-tools, orchestration.
- [kagent](https://www.automicvault.com/zh-hans/pkg/brew/kagent/) - Shares av.db curated category or tags: ai, cli, developer-tools, orchestration.
- [nanobot](https://www.automicvault.com/zh-hans/pkg/brew/nanobot/) - Shares av.db curated category or tags: ai, cli, developer-tools, orchestration.
- [aoe](https://www.automicvault.com/zh-hans/pkg/brew/aoe/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [cc-connect](https://www.automicvault.com/zh-hans/pkg/brew/cc-connect/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [cc-switch-cli](https://www.automicvault.com/zh-hans/pkg/brew/cc-switch-cli/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [claude-squad](https://www.automicvault.com/zh-hans/pkg/brew/claude-squad/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [dstack](https://www.automicvault.com/zh-hans/pkg/brew/dstack/) - Shares av.db curated category or tags: ai, cli, orchestration.
- [mistral-vibe](https://www.automicvault.com/zh-hans/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/zh-hans/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/zh-hans/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)


## 来源

- 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
