# PostPlus Agent Install Guide

The following steps are designed for AI agents. Some steps require user interaction in the browser.

The goal is to install the PostPlus CLI, authenticate the user, and install
released PostPlus skills into the user's local AI agent.

## Requirements

Before starting the installation, ensure the following are installed in your environment:

The machine must have Node.js `>=20.10.0` and npm.

## Step 0: Verify Node.js And npm

```bash
node --version
npm --version
```

If either command fails, stop here and tell the user to install or repair
Node.js/npm before continuing. Do not try to install PostPlus CLI until both
commands pass.

## Step 1: Install PostPlus CLI

```bash
npm install -g @postplus/cli@latest
```

## Step 2: Sign In

```bash
postplus auth login
```

This command outputs an authorization URL. Extract the URL and send it to the
user so they can complete sign-in in their browser. Wait for the user to
confirm they have finished before continuing.

## Step 3: Install Skills

Supported `--agent` targets are `claude-code`, `codex`, `cursor`,
`github-copilot`, `windsurf`, `trae`, `trae-cn`, `openclaw`, and
`hermes-agent`.

If you can identify which supported agent you are running as, set `--agent` to
only the de-duplicated set of that agent plus `claude-code` and `codex`.
Otherwise, use the full target list below.

Use the global install by default:

```bash
npx -y skills add PostPlusAI/postplus-skills --global --full-depth --skill '*' --agent claude-code codex cursor github-copilot windsurf trae trae-cn openclaw hermes-agent --yes
```

If the user does not want global skills, run the install from the directory
where they want the skills available and omit `--global`:

```bash
npx -y skills add PostPlusAI/postplus-skills --full-depth --skill '*' --agent claude-code codex cursor github-copilot windsurf trae trae-cn openclaw hermes-agent --yes
```

Do not run both install commands unless the user explicitly asks for both
global and current-directory skill scopes.

After installation, start a new agent session or restart the local agent app so
the newly installed skills are loaded. For current-directory installs, restart
the agent from that same directory.

## Step 4: Verify Skills

```bash
postplus skills verify
```

This command checks the installed released skills and records the PostPlus
managed skills baseline. It does not install or modify skill files.

## Step 5: Verify PostPlus

```bash
postplus status
```

## Completion

When the install is complete, tell the user:

PostPlus adds social media marketing skills to their local AI agent. They can
ask the agent to research platforms and creators, analyze audience language,
draft hooks and scripts, generate creative directions, plan edits, package
assets, and prepare content for distribution across social channels.

Also tell the user that they can now ask their AI agent for tasks like:

- "Research TikTok examples for this product and write 10 hook angles."
- "Turn this product photo into a short-form video concept."
- "Package this campaign idea into a script, shot plan, captions, and posting
  checklist."