clix0 0.5.1

X from terminal. Built for humans and AI agents. No API keys.

Why?

Twitter killed free API access. clix uses cookie-based auth — just log in with your browser, and you're in. Zero API keys, zero OAuth dance.

Three interfaces, one tool: rich terminal output for humans, --json/--yaml/--compact for scripts, and a built-in MCP server for AI agents.

Quick Start

# install
uv pip install clix0

# authenticate (extracts cookies from your browser)
clix auth login

Commands

Content

Actions

Scheduled Tweets

Lists

Jobs

Direct Messages

System

Output Modes

Every command supports --json for structured output. Pipe detection is automatic — non-TTY gets JSON by default.

# structured JSON
clix feed --json | jq '.tweets[0].text'

# token-optimized for AI agents
clix feed --compact

# YAML
clix feed --yaml

# full text (no truncation)
clix feed --full-text

MCP Server

clix ships as an MCP server — any MCP-compatible client can use it.

{
  "mcpServers": {
    "clix": {
      "command": "uvx",
      "args": ["clix0", "mcp"]
    }
  }
}

Or with explicit auth:

{
  "mcpServers": {
    "clix": {
      "command": "uvx",
      "args": ["clix0", "mcp"],
      "env": {
        "X_AUTH_TOKEN": "your-token",
        "X_CT0": "your-ct0"
      }
    }
  }
}

46 tools covering all commands: feed, search, trending, tweets, users, bookmarks, lists, DMs, jobs, post, delete, like, unlike, retweet, unretweet, bookmark, unbookmark, follow, unfollow, block, unblock, mute, unmute, schedule, download, and more.

Proxy Support

# via environment variable
CLIX_PROXY=socks5://127.0.0.1:1080 clix feed

# via config
clix config set network.proxy socks5://127.0.0.1:1080

Contributing

See CONTRIBUTING.md.

Disclaimer

This tool is for educational and personal use only. It is not affiliated with, endorsed by, or associated with X Corp (formerly Twitter). Use at your own risk. The authors are not responsible for any consequences resulting from the use of this software. By using this tool, you agree to comply with X/Twitter's Terms of Service.

License

MIT