Reference

CLI Reference

@tailor-app/cli v0.7.0 — 14 command groups for document management, review workflows, and multi-agent collaboration.

Installation

Terminal

npm install -g @tailor-app/cli
tailor --help

Requires Node.js 20+. Verify with tailor --version.

Authentication

Environment Variable (recommended for agents & CI/CD)

bash

export TAILOR_API_KEY=tailor_sk_YOUR_KEY
tailor list   # works immediately — no login needed

No tailor login needed. Env vars override stored config. TAILOR_BASE_URL defaults to https://tailor.au.

Store API Key to Disk

bash

tailor login --key tailor_sk_YOUR_KEY

Verify Current Auth

bash

tailor login --check

Non-interactive — validates your current API key or token and shows the source (env var or config file).

Magic Link (for humans in a terminal)

bash

tailor login --email you@company.com

Opens a browser for one-click sign-in, or enter the 6-digit code manually. Requires a TTY.

Documents

6 commands

tailor upload<files...>

Upload documents (DOCX, PDF, MD, HTML) or entire folders.

tailor list

List documents with pagination and tag filtering.

tailor status<docId>

Show status, reviewers, comment/change counts.

tailor download<docId>

Download a document binary.

tailor attach<docId> <files...>

Attach supporting reference documents.

tailor tagadd | remove | list

Tag and organise documents.

upload options

--share	Create shareable links after upload
--permission <perm>	ReadOnly, CommentOnly, or FullReview	FullReview
--public	No email verification required
--access <mode>	open, closed-individual, or closed-org	open
--reviewers <emails>	Comma-separated reviewer emails
--domain <domain>	Allowed email domain (e.g. tailor.au)
--json	Output as JSON

Examples

Upload a folder + create share links

tailor upload ./deliverables/ --share --permission CommentOnly

List documents filtered by tag

tailor list --tag compliance --json | jq '.data[].title'

Collaboration

4 commands

tailor share<docId>

Create a shareable review link with access controls.

tailor commentslist | add | resolve

View, add, or resolve comments on a document.

tailor reviewslist | accept | submit

Manage review invitations and submissions.

tailor changes<docId>

View tracked changes (insertions, deletions, formatting).

share options

--permission <perm>	ReadOnly, CommentOnly, or FullReview	FullReview
--public	No email verification required
--access <mode>	open, closed-individual, or closed-org	open
--reviewers <emails>	Comma-separated emails (for closed-individual)
--domain <domain>	Allowed domain (for closed-org)

Examples

Restricted share link

tailor share abc123-def456 --access closed-org --domain logan.qld.gov.au

List open comments

tailor comments list abc123-def456 --unresolved

Agents (PACT)

46 subcommands

The tailor tap command group implements PACT — the Protocol for Agent Consensus and Truth — enabling AI agents to collaboratively review and edit documents.

Document

join, leave, get, sections, agents, events

Proposals

propose, proposals, approve, reject, object

ICS

intent, constrain, salience, salience-map

Live

poll, watch, done, completions, lock, unlock

Escalation

escalate, ask-human, respond, resolve

Barriers

classify, clearances, frameworks

Quick example — full agent cycle

Agent: join → read → propose → leave

# Join as an agent
tailor tap join <docId> --as "compliance-bot" --role editor

# Read the document and section tree
tailor tap get <docId>
tailor tap sections <docId>

# Declare intent before writing
tailor tap intent <docId> --section sec:liability \
  --goal "Add currency risk language" --category compliance

# Check constraints from other agents
tailor tap constraints <docId> --section sec:liability

# Propose a change
tailor tap propose <docId> --section sec:liability \
  --content "## Liability\n\nRevised clause with currency risk..." \
  --summary "Added currency risk allocation"

# Signal done and leave
tailor tap done <docId> --status aligned --summary "Compliance review complete"
tailor tap leave <docId>

Full PACT integration guide

Account

3 commands

tailor login

Authenticate with Tailor via API key, magic link, or interactive prompt.

tailor keyscreate | list | revoke

Create, list, and revoke API keys.

tailor adminlogin | create-org | list-orgs | ...

Organisation, user, domain, and BYOK management.

keys create options

--name <name>	Key name (e.g. "CI Pipeline")	required
--scopes <scopes>	Comma-separated scopes	documents:read,documents:write
--expires <days>	Days until expiry	365
--no-save	Don't auto-save key to CLI config

Examples

Create a scoped API key

tailor keys create --name "CI Pipeline" --scopes documents:read --expires 90

Global Options

Flag	Description
--json	Machine-readable JSON output (most commands)
-V, --version	Show version number
-h, --help	Show help for any command or subcommand

Configuration

Config stored at ~/.config/@tailor-app/cli/config.json

Environment variables take precedence over stored config:

TAILOR_API_KEYoverrides stored API key
TAILOR_BASE_URLoverrides stored base URL (default: https://tailor.au)