# Pinix — Agent Harness

> Pinix gives AI agents real-world capabilities through Clips — while
> keeping every action visible, controllable, and revocable.
> Local first. Your data never leaves your device.

## What is Pinix

Pinix is an open capability layer for AI agents. It wraps devices, apps,
websites, services, and workflows into **Clips** — self-contained capability
units that any agent can discover and invoke.

Key concepts:
- **Clip** — a capability unit (browser automation, file access, web scraping, etc.)
- **Hub** — routes invoke calls to the right Clip
- **Provider** — a device running Clips (your laptop, a server, a Docker container)
- **bb-browser** — turns any website into an agent-callable Clip using a real Chrome

## Install

```bash
# Full install (macOS / Linux) — includes Node.js, Bun, bb-browser, Chrome
curl -fsSL dl.pinixai.com/install.sh | sh

# CLI only (just the pinix binary, ~18MB)
curl -fsSL dl.pinixai.com/install.sh | sh -s -- --cli

# Docker (one token, zero config)
docker run -d --shm-size=2g lueco/pinix <hub-token>
```

## Quick Start

```bash
pinix start                          # start the daemon
pinix login                          # browser-based login
pinix login --token pnx_...          # or token-based login
pinix hub list                       # see available Clips
pinix invoke <clip> <command>        # call a Clip
pinix invoke todo list               # example: list todos
pinix invoke google search --query "AI agent"  # example: search Google
```

## CLI-only Mode (no daemon)

For agents that only need to invoke Clips on a remote provider:

```bash
pinix login --token pnx_...          # connect to Cloud Hub
pinix registry search <query>        # search Clips
pinix hub add @pinix/todo            # install a Clip (on remote provider)
pinix hub list                       # see available Clips
pinix invoke todo list               # call a Clip
```

## Upgrade

```bash
pinix upgrade                        # updates pinix + bb-browser + bb-viewer
```

## MCP Integration

Pinix provides an MCP gateway for agents that support Model Context Protocol:

```bash
pinix hub mcp                        # start MCP server (stdio)
```

## Key URLs

- Website: https://pinixai.com
- Console: https://console.pinixai.com
- API: https://api.pinixai.com
- Hub: https://hub.pinixai.com
- GitHub: https://github.com/epiral/pinix
- Install script: https://dl.pinixai.com/install.sh
- Docker image: https://hub.docker.com/r/lueco/pinix

## For Agents

If you are an AI agent and want to use Pinix:

1. Install: `curl -fsSL dl.pinixai.com/install.sh | sh -s -- --cli`
2. Login: `pinix login --token <token>` (get token from your user)
3. List available Clips: `pinix hub list`
4. Invoke: `pinix invoke <clip> <command> [-- --arg value]`

All Clips listed by `pinix hub list` can be invoked directly. No need to
`hub add` first — Clips are served by online Providers.