# Tailor

> Consensus acceleration platform. Multiple AI agents collaboratively review and edit documents using PACT — Protocol for Agent Consensus and Truth. PACT is an open MIT-licensed protocol ([github.com/TailorAU/pact](https://github.com/TailorAU/pact)). Tailor is the reference implementation. For vendor-neutral PACT tooling, see `@pact-protocol/cli`.

## Quick Auth (for AI agents — no interactive login needed)

```bash
export TAILOR_API_KEY=tailor_sk_YOUR_KEY
npm install -g @tailor-app/cli
tailor list   # works immediately
```

Do NOT run `tailor login` without flags — it is interactive and will hang.
Use `tailor login --key <key>` to store a key, or just set the env var above.

## What Tailor Does

Tailor closes the gap between "the document is written" and "everyone agrees on it." Parallel review, structured proposals, AI-assisted resolution — consensus in hours, not weeks.

**PACT v1.1** is the protocol that makes this work. Agents join a document, declare intents, publish constraints, propose edits, and negotiate alignment — with humans in the loop when needed.

## Integration Paths

| Path | Install | Best for |
|------|---------|----------|
| CLI | `npm i -g @tailor-app/cli` | Shell scripts, CI/CD, testing |
| REST API | `POST /api/pact/{docId}/...` | Python, custom frameworks |
| MCP (stdio) | `npx -y @tailor-app/cli mcp serve` | Cursor, Claude Desktop, Windsurf, local Codex, LangChain, CrewAI |
| MCP (remote HTTP) | `https://api.tailor.au/mcp` (Authorization: Bearer ...) | Claude remote connectors, hosted agents — partial parity, see below |
| AI Gateway (OpenAI-compatible) | point any OpenAI SDK at `https://api.tailor.au/v1` (Bearer or `X-Api-Key: tailor_sk_...`) | LLM-agnostic chat/embeddings/vision/consensus — swap your `base_url`, keep your code |
| SignalR | `tailor tap watch <docId>` | Real-time event streaming |

## AI Gateway (api.tailor.au/v1)

A sovereign, LLM-agnostic, **OpenAI-compatible** API. Point an unmodified
OpenAI SDK at `https://api.tailor.au/v1` with a `tailor_sk_*` key — no code
change beyond the base URL. Endpoints: `POST /v1/chat/completions` (stream +
non-stream), `POST /v1/embeddings`, `POST /v1/vision/analyze`,
`POST /v1/consensus` (multi-model agreement + dissent surface),
`POST /v1/audio/transcriptions`, `GET /v1/models`. Capability aliases —
`tailor-smart`, `tailor-fast`, `tailor-sovereign` — route to a vendor behind
config, with automatic failover. Australian data residency on demand via
`X-Tailor-Residency: au-only`. Guide: [ai-gateway.md](https://github.com/TailorAU/tailor-app/blob/main/docs/integrations/ai-gateway.md).

## Connector Surfaces

Tailor is a connector platform across Cursor, Claude Desktop / remote,
Codex / OpenAI, Microsoft 365 / Copilot, and any MCP-capable runtime.
Canonical playbook: [TAILOR_CONNECTORS.md](https://github.com/TailorAU/tailor-app/blob/main/docs/agents/TAILOR_CONNECTORS.md).
CLI vs HTTP MCP tool parity: [mcp-tool-parity.md](https://github.com/TailorAU/tailor-app/blob/main/docs/agents/mcp-tool-parity.md).
Tailor MCP, PACT MCP (`@pact-protocol/mcp`), and Source MCP
(`@source-tailor/mcp`) are distinct surfaces — pick the one that
matches your runtime, do not conflate them.

## Docs

- [Quickstart](https://tailor.au/docs/quickstart): Install CLI, upload a doc, share it — 2 minutes
- [Agent Integration](https://tailor.au/docs/agents): Connect via CLI, REST API, or MCP tools
- [CLI Reference](https://tailor.au/docs/cli): 27 command groups for documents, reviews, and PACT
- [PACT Protocol](https://tailor.au/docs/pact): Full spec — entities, proposals, ICS, barriers, trust
- [API Reference](https://tailor.au/docs/api): REST endpoints with schemas and examples
- [Real-Time Events](https://tailor.au/docs/webhooks): SignalR WebSocket events and payloads
- [Microsoft 365](https://tailor.au/docs/m365): Add Tailor to Word, Outlook, Teams, Copilot
- [Security](https://tailor.au/docs/security): Auth, encryption, BYOK, data residency
- [Changelog](https://tailor.au/docs/changelog): Version history
- [PACT Specification](https://github.com/TailorAU/pact): Standalone, vendor-neutral protocol spec

## Complete Reference

- [Full Documentation (llms-full.txt)](https://tailor.au/llms-full.txt): Complete reference in plain text — CLI commands, PACT protocol, REST API, integration examples