Vista Social CLI

CLI and Claude Code skills for the Vista Social API. Manage profiles, posts, analytics, and inbox from the terminal or let Claude do it for you.

Quick Start

# 1. Install globally
npm install -g vista-social-cli

# 2. Set up skills in your project
cd your-project
vista init

# 3. Add your API key to .env
echo "VISTA_SOCIAL_API_KEY=your_key_here" >> .env

# 4. Try it
vista profiles --format table

Get your API key from Vista Social Settings > Integrations.

Each project uses its own .env — keys are never shared across repos.

Commands

| Command | Description | |---------|-------------| | vista profiles | List connected social profiles | | vista groups | List profile groups | | vista posts list | List posts by status (published/scheduled/draft/failed) | | vista posts create | Create or schedule a post | | vista comments list | List comments on a post | | vista comments create | Comment on a post | | vista analytics daily | Daily performance metrics | | vista analytics posts | Per-post performance metrics | | vista inbox list | List inbox items (comments, mentions, messages) | | vista inbox reply | Reply to an inbox item |

Global Options

• --format json|table — output format (default: json)
• --verbose — log HTTP request details to stderr
• --dry-run — preview write operations without executing (posts create, comments create, inbox reply)

Examples

# List all profiles
vista profiles --format table

# Find a profile by name
vista profiles --query "Instagram"

# Last 7 days analytics
vista analytics daily --profile-id 470558 --last-7-days --format table

# Last 30 days post performance
vista analytics posts --profile-id 470558 --last-30-days

# Create a post (dry-run first)
vista posts create --message "Hello world!" --profile "Acme Facebook" --publish-at now --dry-run
vista posts create --message "Hello world!" --profile "Acme Facebook" --publish-at now

# List inbox
vista inbox list --format table

Claude Code Skills

Run vista init in any project to install 4 Claude Code skills into .claude/skills/:

| Skill | Auto-invokes? | What it does | |-------|---------------|-------------| | vista-profiles | Yes | Profile and group lookup | | vista-analytics | Yes | Daily and post performance metrics | | vista-posts | No (write safety) | Post and comment management | | vista-inbox | No (write safety) | Inbox and reply management |

Read skills (profiles, analytics) auto-invoke from natural language — just say "show me my profiles" or "how did my posts perform last week".

Write skills (posts, inbox) require explicit invocation and always use --dry-run first for confirmation before executing.

Programmatic Usage

import { VistaClient } from 'vista-social-cli';

const client = new VistaClient({ apiKey: process.env.VISTA_SOCIAL_API_KEY });

const profiles = await client.getProfiles({ q: 'Instagram' });
const daily = await client.getDailyPerformance({
  profile_id: 470558,
  date_from: '20260301',
  date_to: '20260331',
});

Development

npm run build      # Build with tsdown
npm test           # Run 172 tests
npm run dev        # Run CLI via tsx (no build needed)
npm run typecheck  # TypeScript type checking

License

MIT -- see LICENSE for details.