Paste an X link and get Markdown you can read, save, or hand to an AI. A thread comes back as every post by the author, in order. A profile comes back as the bio and recent posts. Every post keeps its author, date, link, media, and engagement stats.

Quick start

npx iloso https://x.com/naval/status/1002103360646823936

Or skip the install: swap x.com for ilo.so in any link. A browser opens the converter; scripts send an API key.

curl -H "Authorization: Bearer $ILO_API_KEY" https://ilo.so/naval/status/1002103360646823936

CLI

npm i -g iloso

ilo https://x.com/naval/status/1002103360646823936
ilo https://x.com/naval/status/1002103360646823936 --format obsidian -o naval.md
ilo https://x.com/naval/status/1002103360646823936 --scope post
ilo profile naval --max 50
ilo https://x.com/naval/status/1002103360646823936 --format json

| Option | Values | Default | | --- | --- | --- | | --format | md, obsidian, json | md | | --scope | thread, post, conversation | thread | | --stats | all, root, off | all | | --max | 1 to 200, for profiles | 20 | | --replies, --reposts | include them, for profiles | off | | -o, --output | a file path | stdout |

Markdown goes to stdout and status lines go to stderr, so piping is safe.

The CLI needs an API key. Run ilo login and approve the code in your browser to create a free account with 50 credits, or set ILO_API_KEY. The CLI guide covers every command.

AI agents

Connect the remote MCP server. It signs in with your ilo account the first time.

claude mcp add --transport http ilo https://ilo.so/mcp

Cursor, Codex, and other clients use the same URL. See the MCP guide.

Install the agent skill so coding agents reach for ilo whenever a task includes an X link:

ilo skill install

TypeScript

import { createClient } from 'iloso'

const ilo = createClient({ apiKey: process.env.ILO_API_KEY })
const thread = await ilo.convert(
  'https://x.com/naval/status/1002103360646823936',
  { format: 'obsidian' },
)

console.log(thread.markdown)
console.log(thread.usage)

The TypeScript guide documents options and errors. The same API is available over HTTP at POST https://ilo.so/api/convert.

Pricing

• 3 free conversions a day in the ilo.so converter without an account.
• The CLI, API, MCP server, and URL swap need an account.
• 50 free credits when you sign up.
• Credit packs from $5 for 1,000 credits. Credits never expire.
• One credit per post returned. Failed conversions cost nothing.

See ilo.so/pricing.

Limits

Only public content works. Deleted, protected, and suspended posts return not found. View counts and some media details can be missing on older posts. Profiles return recent posts, not the full history.

Upgrading from 0.x

iloso 1.0 replaces the 0.x drafting, scheduling, publishing, and research commands with X to Markdown conversion. Pin iloso@0 if you still need them. Their local data in ~/.config/ilo is left untouched.

Support

Questions and security reports: [email protected]. Do not send credentials, tokens, or personal data through a public channel.

License

The published iloso package files are available under MIT.