{"slug": "show-hn-a-linkedin-x-cli-for-your-agents", "title": "Show HN: A LinkedIn / X CLI for your agents", "summary": "CyrusNewDay launched a CLI tool called 'social' that lets AI agents interact with LinkedIn and X accounts via JSON commands, with caching and local mirroring to reduce costs. The tool is designed for agent-first usage, supporting deterministic exit codes and structured errors.", "body_md": "**Accounts** — social account connect linkedin · social account reconnect linkedin <account> · social account disconnect linkedin <account> · social account billing · social account. Connect, re-auth, inspect billing, and list the accounts on this network.\n\n**Accounts** — social account connect x · social account reconnect x <account> · social account disconnect x <account> · social account billing · social account. Connect, re-auth, inspect billing, and list the accounts on this network.\n\n**Composable with the tools you already use.** Every command speaks JSON. Pipe through\n\n`jq`\n\n, `fzf`\n\n, your agent's planner — anything that reads stdin.**Shared command patterns across both networks.**\n\n`--limit`\n\nbounds pages, LinkedIn list reads use `--offset`\n\n, and offset responses can expose `.meta.totalCount`\n\n. Cursor-based reads use `--cursor`\n\nand `.meta.cursor`\n\n; cacheable reads also take `-H \"Cache-Control: no-cache\"`\n\nfor fresh upstream reads.**Repeated exploration can get cheaper.** Allowlisted GET reads can hit cache when your agent asks the same question again, so those repeat hits cost\n\n`$0`\n\n.**Designed for agents first.** Deterministic exit codes, structured errors, and a\n\n`SKILL.md`\n\nyou drop straight into Claude, Codex, or any other agent.Agents tend to ask the same read questions while exploring. social has two read layers: live proxy reads, where selected repeats can hit cache, and the local mirror, where synced data can be queried for free with SQL.\n\n`sync`\n\npulls your own data into the local mirror and can spend usage. `sql`\n\nqueries that mirror read-only, returns the standard envelope, and omits `meta.cost`\n\n.**15 minutes**. Change it with\n\n`social account config cache ttl {total_in_seconds}`\n\n.`-H \"Cache-Control: no-cache\"`\n\non cacheable read commands when freshness matters. It skips the cached read and refreshes the stored response after a successful upstream call.`no-store`\n\nbypasses cache read and write; `max-age=<seconds>`\n\noverrides the TTL for one request.`ETag`\n\nand `Last-Modified`\n\n. The request cache surface is still `Cache-Control`\n\n; use `no-cache`\n\nfor a fresh upstream read.`meta.cache.tables`\n\n, including last sync time and age.**mode 0600**. Stored in your OS keyring when one is available; this file is the fallback.\n\n**social account login**:\n\n**read,write**(default) or\n\n**read**. Carried in the token and revocable with\n\n**social account logout**— there is no ambient write access.\n\n`Cache-Control: no-cache`\n\n, `no-store`\n\n, or `max-age=<seconds>`\n\nwhen the command lists `--header`\n\n.`read,write`\n\n. Clear Write in the prompt for a session that can't post, invite, or follow.`$0`\n\n. Audit it any time with `social account billing`\n\n, `social account usage`\n\n, and `social account logs`\n\n— nothing happens on your accounts you can't see.[LinkedIn Account Safety](/security/linkedin).\n\nBuilt by [@CyrusNewDay](https://x.com/cyrusnewday) because it's a tool he needed.", "url": "https://wpnews.pro/news/show-hn-a-linkedin-x-cli-for-your-agents", "canonical_source": "https://usesocial.dev", "published_at": "2026-07-07 23:47:47+00:00", "updated_at": "2026-07-08 00:01:38.943554+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-tools"], "entities": ["LinkedIn", "X", "Claude", "Codex", "CyrusNewDay"], "alternates": {"html": "https://wpnews.pro/news/show-hn-a-linkedin-x-cli-for-your-agents", "markdown": "https://wpnews.pro/news/show-hn-a-linkedin-x-cli-for-your-agents.md", "text": "https://wpnews.pro/news/show-hn-a-linkedin-x-cli-for-your-agents.txt", "jsonld": "https://wpnews.pro/news/show-hn-a-linkedin-x-cli-for-your-agents.jsonld"}}