@link.me/cli 0.1.0

package/README.md

@@ -0,0 +1,238 @@
+# @link.me/cli
+
+Command-line interface for the [Linkme](https://link.me) 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
+
+```bash
+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
+
+```bash
+# Authenticate
+linkme auth login --email you@example.com --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:
+
+```bash
+# 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 email and password |
+| `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
+
+```bash
+# 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:
+
+```bash
+npm install -g @link.me/mcp
+```
+
+See [@link.me/mcp](https://www.npmjs.com/package/@link.me/mcp) for setup instructions.
+
+## License
+
+UNLICENSED

package/package.json

@@ -0,0 +1,29 @@
+{
+	"name": "@link.me/cli",
+	"version": "0.1.0",
+	"description": "Linkme platform CLI for agents, scripts, and automation",
+	"license": "UNLICENSED",
+	"bin": {
+		"linkme": "./run.js"
+	},
+	"files": [
+		"run.js"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/LinkMeGlobal/cli.git",
+		"directory": "bin/cli"
+	},
+	"keywords": [
+		"linkme",
+		"cli",
+		"automation"
+	],
+	"optionalDependencies": {
+		"@link.me/cli-darwin-arm64": "0.1.0",
+		"@link.me/cli-darwin-x64": "0.1.0",
+		"@link.me/cli-linux-x64": "0.1.0",
+		"@link.me/cli-linux-arm64": "0.1.0",
+		"@link.me/cli-windows-x64": "0.1.0"
+	}
+}

package/run.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("node:child_process");
+const path = require("node:path");
+const os = require("node:os");
+
+const PLATFORMS = {
+	"darwin-arm64": "@link.me/cli-darwin-arm64",
+	"darwin-x64": "@link.me/cli-darwin-x64",
+	"linux-x64": "@link.me/cli-linux-x64",
+	"linux-arm64": "@link.me/cli-linux-arm64",
+	"win32-x64": "@link.me/cli-windows-x64",
+};
+
+const key = `${os.platform()}-${os.arch()}`;
+const pkg = PLATFORMS[key];
+
+if (!pkg) {
+	console.error(
+		`@link.me/cli: unsupported platform ${key}. Supported: ${Object.keys(PLATFORMS).join(", ")}`,
+	);
+	process.exit(1);
+}
+
+let binPath;
+try {
+	const pkgDir = path.dirname(require.resolve(`${pkg}/package.json`));
+	binPath = path.join(
+		pkgDir,
+		os.platform() === "win32" ? "linkme.exe" : "linkme",
+	);
+} catch {
+	console.error(
+		`@link.me/cli: could not find ${pkg}. Try reinstalling with:\n  npm install @link.me/cli`,
+	);
+	process.exit(1);
+}
+
+try {
+	execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (e) {
+	if (e.status !== undefined) process.exit(e.status);
+	throw e;
+}