<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

Installation

README.md

Why advai-cli

Highlights

Architecture

Related tools