advai-cli

<p align="center" <img src="docs/assets/hero.png" alt="advai-cli hero" width="100%" / </p

<h1 align="center"advai-cli</h1

<p align="center" A unified CLI for local skills, browser automation, external CLIs, and terminal AI chat. </p

<p align="center" <a href="https://github.com/Advai-X/advai-cli/actions/workflows/ci.yml"<img src="https://github.com/Advai-X/advai-cli/actions/workflows/ci.yml/badge.svg" alt="CI" /</a <a href="https://pypi.org/project/advai-cli/"<img src="https://img.shields.io/pypi/v/advai-cli" alt="PyPI Version" /</a <a href="https://www.npmjs.com/package/advai-cli"<img src="https://img.shields.io/npm/v/advai-cli" alt="npm Version" /</a <a href="https://pypi.org/project/advai-cli/"<img src="https://img.shields.io/pypi/pyversions/advai-cli" alt="Python Versions" /</a <a href="LICENSE"<img src="https://img.shields.io/pypi/l/advai-cli" alt="License" /</a <a href="https://github.com/Advai-X/advai-cli/stargazers"<img src="https://img.shields.io/github/stars/Advai-X/advai-cli?style=flat" alt="GitHub stars" /</a <a href="https://github.com/Advai-X/advai-cli/issues"<img src="https://img.shields.io/github/issues/Advai-X/advai-cli" alt="GitHub issues" /</a </p

<p align="center" <a href="#why-advai-cli"Why</a • <a href="#installation"Installation</a • <a href="#quick-start"Quick Start</a • <a href="#browser-automation"Browser</a • <a href="#common-commands"Commands</a • <a href="#tui"TUI</a • <a href="#development"Development</a </p

advai-cli is a unified command-line interface for managing local skills, driving a Chrome extension-backed browser bridge, working with external CLIs, and chatting with AI from the terminal through a single advai entrypoint.

It is designed as a lightweight Python-first core with npm and Homebrew distribution options, making it easy to install in different developer environments while keeping the runtime model simple, local-first, and predictable.

Why advai-cli

• One entrypoint for runtime inspection, local skill management, external CLI workflows, and terminal-native AI chat
• Chrome extension-backed browser automation through advai browser
• Python core for a small, dependency-light implementation
• npm wrapper for teams that prefer JavaScript-based distribution
• Homebrew formula for macOS-friendly installation
• OpenAI-compatible backend support for flexible AI provider integration

• Local-first state stored under ~/.advai

Highlights

• Inspect the current installation, runtime, and recommended update command with advai info and advai update
• Manage locally installed skills with install, list, info, update, and uninstall commands
• Sync installed skills into platform-specific agent directories such as Cursor, Claude Code, Codex, TRAE, and more
• Open, inspect, extract, and automate browser sessions with advai browser
• Discover and install supported third-party CLIs through the OpenCLI ecosystem
• Create local knowledge bases, add documents, search content, and resync from source files

• Proxy supported external CLIs through advai cli <name ...
• Launch a terminal chat UI with configurable model, base URL, system prompt, and transcript export

Architecture

flowchart LR
    U[Developer] --> A[advai command]

    subgraph Distribution
        P[PyPI package]
        N[npm wrapper]
        B[Homebrew formula]
    end

    P --> A
    N --> A
    B --> A

A -- C[Python CLI core] C -- S[Local Skills Manager] C -- BB[Browser Bridge] C -- O[OpenCLI Bridge] C -- T[Terminal TUI] C -- I[Runtime Inspection]

S -- FS[~/.advai/skills] BB -- BSD[~/.advai/browser] BB -- EXT[Browser extension + local daemon] T -- API[OpenAI-compatible API] O -- OC[opencli binary]

## Installation

### Requirements

- Python `3.10+`
- Node.js `14+` only if you install through npm
- A local Python runtime is still required when using the npm package
- `opencli` is required only for external CLI discovery, install, and passthrough execution
- A compatible browser extension/runtime is required only if you want to use `advai browser`

### Install from PyPI