@link.me/cli

Command-line interface for the Linkme platform. Manage your profile, links, content, analytics, and multi-platform publishing from the terminal.

Built for agents, CI/CD pipelines, scripts, and power users.

Install

npm install -g @link.me/cli

Pre-compiled binaries are provided for macOS (arm64, x64), Linux (x64, arm64), and Windows (x64). No runtime dependencies required.

Quick Start

# Authenticate in the browser
linkme auth login

# Print the browser URL and exit
linkme auth login --manual

# Finish a manual browser login after approval
linkme auth resume

# Authenticate with email/password flags for CI
linkme auth login --email [email protected] --password '***'

# View your profile
linkme profile

# List your links
linkme links list

# Post a video to YouTube, Instagram, and TikTok simultaneously
linkme ap upload ./video.mp4
linkme ap post create --video u/42/uploaded-key --caption "New video!" --platforms youtube,instagram,tiktok

# Check analytics
linkme analytics overview

Output Modes

Every command supports three output modes:

# Human-readable (default)
linkme profile

# JSON for piping and scripting
linkme profile --json

# Quiet mode - single most useful value
linkme profile --quiet

Commands

Authentication

| Command | Description | |---------|-------------| | auth login | Log in with browser auth by default, or email/password flags | | auth resume | Finish a pending browser login started with auth login --manual | | auth logout | Log out and clear stored tokens | | auth sessions | List active sessions | | auth switch | Switch the active profile | | whoami | Show current identity |

Profile

| Command | Description | |---------|-------------| | profile | View your profile | | profile edit | Edit profile fields (name, bio, etc.) | | profile theme | Manage theme colors | | profile linkme-icon | Toggle Linkme icon visibility | | profile pixels | Manage tracking pixels | | profile contact list\|set\|delete | Manage contact info | | profile sections list\|enable\|disable\|move | Manage section visibility and order | | profile events list\|add\|edit\|delete | Manage custom events | | profile forms list\|create\|edit\|delete\|submissions\|export | Manage forms | | profile video show\|set\|remove | Manage profile video | | profile bands-in-town show\|sync\|events\|colors | Manage BandsInTown integration |

Links

| Command | Description | |---------|-------------| | links list | List profile links | | links add | Add a new link | | links edit | Edit an existing link | | links delete | Delete a link | | links reorder | Reorder link groups interactively |

Featured Links

| Command | Description | |---------|-------------| | featured list\|add\|edit\|delete | Manage featured links | | featured headers list\|add\|edit\|delete | Manage profile headers | | featured multilinks list\|add\|edit\|delete | Manage music smart links |

Social

| Command | Description | |---------|-------------| | social list | List social network links | | social set | Set a social network URL |

AP (Post on All Platforms)

| Command | Description | |---------|-------------| | ap accounts | List connected provider accounts | | ap connect <provider> | Connect YouTube, Instagram, or TikTok | | ap disconnect <provider> <id> | Disconnect a provider account | | ap upload <file> | Upload a video file | | ap post create | Create a new post | | ap post list | List posts | | ap post status <id> | Check post status | | ap post watch <id> | Watch status in real-time | | ap post publish <id> | Publish a draft | | ap post cancel <id> | Cancel a pending post | | ap post retry <id> | Retry a failed post | | ap analytics <id> | Post analytics | | ap analytics accounts | Analytics across all accounts |

Analytics

| Command | Description | |---------|-------------| | analytics overview | Aggregated analytics | | analytics visits | Visit breakdown over time | | analytics links | Per-link click analytics | | analytics geo | Geographic breakdown | | analytics realtime | Real-time visitor count |

Email

| Command | Description | |---------|-------------| | email send | Send a campaign | | email test | Send a test email | | email history | View campaign history | | email detail <id> | Campaign details and metrics | | email cancel <id> | Cancel a scheduled campaign | | email domains | List verified sending domains | | email upload-image | Upload an embedded image | | email templates list\|create\|delete | Manage templates |

Contacts

| Command | Description | |---------|-------------| | contacts list | List collected contacts | | contacts stats | Contact analytics |

Commerce & Shop

| Command | Description | |---------|-------------| | commerce products list\|create\|delete | Digital products | | commerce merch list\|categories | Merch catalog | | shop products list\|add\|edit\|delete | Shop products | | shop categories list\|add\|edit\|reorder\|delete | Shop categories |

Automations

| Command | Description | |---------|-------------| | automations list | List automations | | automations get <id> | View an automation | | automations create | Create an automation | | automations update <id> | Update an automation | | automations publish <id> | Publish an automation | | automations deactivate <id> | Deactivate an automation | | automations delete <id> | Delete an automation | | automations duplicate <id> | Duplicate an automation | | automations metrics <id> | Automation metrics | | automations analytics <id> | Automation analytics | | automations monitor <id> | Monitor performance | | automations connection | Instagram connection status | | automations authorize | Get Instagram OAuth URL | | automations disconnect | Disconnect Instagram |

Other

| Command | Description | |---------|-------------| | gallery upload\|list\|delete\|reorder | Manage gallery media | | courses list\|get\|create\|update\|delete\|restore | Manage courses | | feeds subscribe\|list\|videos\|poll\|unsubscribe | Feed subscriptions | | reviews subscribe\|list\|show\|unsubscribe | Review subscriptions | | agency create\|list\|invite\|users\|remove\|manage\|invitations | Agency management | | upgrade pro | Upgrade to Linkme Pro | | config show\|set\|reset | CLI configuration | | completion <shell> | Generate shell completions (bash, zsh, fish) |

Global Flags

| Flag | Description | |------|-------------| | --json | Structured JSON output | | --quiet | Suppress non-essential output | | --verbose | Diagnostic details | | --no-color | Disable ANSI colors | | --profile <name> | Named Linkme profile | | -V, --version | Version info |

Environment Variables

| Variable | Description | |----------|-------------| | LINKME_TOKEN | Auth token (overrides stored credentials) | | LINKME_API_URL | Override API base URL | | LINKME_AUTH_URL | Override auth service URL | | LINKME_AP_URL | Override AP service URL | | LINKME_NO_UPDATE_CHECK | Set 1 to disable update checks | | NO_COLOR | Disable ANSI colors |

CI/CD Usage

# Authenticate with a token
export LINKME_TOKEN="your-api-token"

# All commands work non-interactively with --json
linkme profile --json | jq '.username'
linkme links list --json | jq '.[].title'
linkme ap post list --json | jq '.[0].id'

MCP Server

An MCP (Model Context Protocol) server is available as a separate package for AI agent integration:

npm install -g @link.me/mcp

See @link.me/mcp for setup instructions.

License

UNLICENSED