Metadata-Version: 2.4
Name: aistorehub
Version: 0.1.1
Summary: The Official CLI for AIStoreHub - Discover, pull, publish, and configure AI systems and MCP servers.
Home-page: https://aistorehub.com
Author: AIStoreHub Team
Author-email: hello@aistorehub.com
License: MIT
Project-URL: Documentation, https://aistorehub.com/docs
Project-URL: Source, https://github.com/aistorehub/aistorehub
Project-URL: Issue Tracker, https://github.com/aistorehub/aistorehub/issues
Keywords: ai,mcp,model-context-protocol,agents,prompts,aistorehub,claude,cursor
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: httpx>=0.25.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# AIStoreHub CLI (`aistorehub` / `aihub`)

[![PyPI Version](https://img.shields.io/pypi/v/aistorehub.svg)](https://pypi.org/project/aistorehub/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Python: 3.9+](https://img.shields.io/badge/python-3.9%2B-blue)](https://www.python.org/)

The official command-line interface for **[AIStoreHub](https://aistorehub.com)** — the open registry and marketplace for autonomous AI systems, model instructions, agent workflows, and Model Context Protocol (MCP) servers.

---

## ⚡ Quick Install

```bash
pip install aistorehub
```

> **Tip:** Both `aistorehub` and `aihub` commands are installed. You can use whichever you prefer!

---

## 🚀 Key Features

* **1-Click MCP Auto-Configuration**: Automatically injects MCP server configs into **Claude Desktop**, **Cursor IDE**, and **Windsurf** with automatic timestamped `.bak` safety backups.
* **Instant Artifact Pull**: Download prompts, schemas, instructions, and test datasets straight into your current directory.
* **Interactive Terminal Search**: Query AI systems, agents, and verified benchmarks without leaving your terminal.
* **10-Second Manifest Inspector**: Inspect local folders to auto-detect system prompts, tool schemas, and capabilities before publishing.
* **Team & Organization RBAC**: Switch between personal workspaces and enterprise multi-tenant organizations seamlessly.

---

## 📖 Command Reference

### 1. Authenticate with Personal Access Token (PAT)
```bash
# Log in with your AIStoreHub API token:
aihub login

# Check authenticated user & organization roles:
aihub whoami
```

### 2. Search Systems & Agents
```bash
# Search by keyword, problem, or capability:
aihub search "sql optimizer"
aihub search "invoice extraction"
```

### 3. Pull System Instructions & Code
```bash
# Pull into current directory:
aihub pull abhinav/sql-optimizer

# Pull into a custom destination folder:
aihub pull abhinav/invoice-agent --dest ./my-tools
```

### 4. 1-Click MCP Server Installation
```bash
# Auto-configure into Claude Desktop and Cursor simultaneously:
aihub mcp abhinav/sql-optimizer

# Or target a specific client:
aihub mcp abhinav/sql-optimizer --client claude
aihub mcp abhinav/sql-optimizer --client cursor
aihub mcp abhinav/sql-optimizer --client windsurf
```

### 5. Inspect Local Folders for Publishing
```bash
# Auto-detect manifests, tools, and prompts in a directory:
aihub inspect ./my-agent-folder
```

---

## ⚙️ Environment Variables

You can optionally configure authentication and API endpoints via environment variables:

* `AISTOREHUB_TOKEN` or `AIHUB_TOKEN`: Personal Access Token (PAT).
* `AISTOREHUB_API_URL` or `AIHUB_API_URL`: Custom API endpoint (default: `https://api.aistorehub.com/api/v1`).

---

## 📄 License

MIT © [AIStoreHub Team](https://aistorehub.com)
