advai-cli  by Advai-X

Unified CLI for local AI skills and terminal automation

Created 1 month ago
311 stars

Top 86.4% on SourcePulse

GitHubView on GitHub
Project Summary

A unified CLI tool designed to streamline developer workflows by consolidating local skill management, browser automation, external CLI integration, and terminal-based AI chat into a single entrypoint. It targets developers and power users seeking a lightweight, local-first, and predictable environment for managing diverse tools and AI interactions.

How It Works

Advai-cli employs a Python-first core, offering flexible distribution via PyPI, an npm wrapper, and a Homebrew formula. It centralizes functionality through distinct bridges: a Local Skills Manager for integrating custom tools, a Browser Bridge leveraging a Chrome extension for web automation, an OpenCLI Bridge for external CLI discovery and execution, and a Terminal TUI for AI chat powered by OpenAI-compatible APIs. This architecture prioritizes a local-first, predictable runtime model with minimal dependencies.

Quick Start & Requirements

  • Installation:
    • PyPI: pip install advai-cli
    • npm: npm install -g advai-cli (installs into a private Python virtual environment)
    • Homebrew: brew tap Advai-X/tap && brew install advai-cli
    • Bootstrap: ./install.sh
  • Prerequisites: Python 3.10+, Node.js 14+ (for npm), opencli binary (for external CLI features), and a compatible browser extension/runtime (for browser automation).
  • Configuration: Set ADVAI_API_KEY environment variable for AI access.
  • Docs/Demos: Core functionality is demonstrated via command-line examples within the README.

Highlighted Details

  • Unified Entrypoint: A single advai command manages local skills, browser automation, external CLIs, and terminal AI chat.
  • Browser Automation: Chrome extension-backed layer for opening URLs, executing JavaScript, waiting for selectors, typing, clicking, and taking screenshots.
  • Skill Management: Install, list, update, and sync local skills to platform-specific agent directories (e.g., Cursor, TRAE IDE, Claude Code). Supports over 50 built-in coding and lobster platforms, plus custom platform registration.
  • External CLI Integration: Discover, install, and execute third-party CLIs via the OpenCLI ecosystem.
  • Terminal AI Chat: An interactive TUI connects to any OpenAI-compatible API endpoint.
  • Knowledge Bases: Create, add documents, search, and sync local knowledge bases, with initial OKF-friendly Markdown support.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or roadmap were provided in the README.

Licensing & Compatibility

  • License: MIT.
  • Compatibility: The MIT license permits broad use, including commercial applications and linking within closed-source projects.

Limitations & Caveats

Currently, advai skill install and advai cli install exclusively support GitHub repository URLs. The knowledge base feature focuses on filesystem-native storage and basic text retrieval, lacking full OKF-aware parsing and structured metadata querying. Browser automation requires the installation of a separate Chrome extension and local runtime.

Health Check
Last Commit

5 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
254 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.