← Back to Skills Marketplace
ignsoftwarellc

X-CLI Toolkit

by IGN Software · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
760
Downloads
2
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install x-cli
Description
Full-featured X/Twitter toolkit — read, search, post, interact, DMs, lists, polls, trends. Cookie auth, proxy support, no API keys needed.
Usage Guidance
This skill appears to do what it says, but exercise caution before installing or using it with your real X account. Key points: - The tool authenticates with either a cookies.json file or username/password stored in config.json. Do NOT paste your account password into a chat with an agent unless you fully trust that agent and environment. - cookies.json contains session tokens that function like passwords; if created, they live in the skill directory and could be read by other processes/users on the machine. Prefer using a throwaway/X test account rather than your primary account. - The README explicitly suggests instructing the agent to clone/install and supply credentials automatically — this is convenient but high-risk. If you use the skill, require manual confirmation before the agent runs login/posting commands and avoid giving credentials via conversational channels. - The code depends on twikit which uses private web GraphQL endpoints (not official API). This can break or violate X's terms of service; consider legal/TOS implications. - If you decide to proceed: review the included scripts (they are present and readable), run them in an isolated environment, inspect the twikit package you install, and avoid running on a shared host. If you want safer usage, consider limiting the skill’s autonomous invocation or using a dedicated account and rotating credentials.
Capability Analysis
Type: OpenClaw Skill Name: x-cli Version: 1.0.0 The OpenClaw x-cli skill is classified as suspicious due to its broad range of powerful capabilities that, while intended for X/Twitter interaction, could be misused by a compromised or misdirected AI agent. Specifically, `scripts/x_extra.py` allows uploading arbitrary files, `scripts/x_post.py` enables posting content, `scripts/x_interact.py` can delete tweets or block users, and `scripts/x_dm.py` can send and read direct messages. While the skill itself does not exhibit malicious intent (e.g., no data exfiltration to external endpoints, no persistence mechanisms), these functionalities represent significant risks if the agent's instructions are subverted or if it's prompted to perform harmful actions. The handling of X/Twitter credentials in `scripts/x_auth.py` and `scripts/x_utils.py` via `config.json` and `cookies.json` is necessary for its operation and confined to the skill's directory, but still involves sensitive data.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the scripts use twikit to interact with X via cookie-based auth and provide reading, search, posting, DMs, lists, media upload, etc. No unrelated credentials or binaries are requested. Requiring a cookies.json or username/password in config.json is consistent with the stated 'cookie auth, no API keys' model.
Instruction Scope
SKILL.md and README instruct the agent to clone, install, configure, and authenticate automatically and explicitly suggest giving username/password to the agent. The code reads/writes config.json and cookies.json in the skill folder and directs the agent to run arbitrary scripts via exec — this expands the agent's access to user credentials and to site content (media fetched via web_fetch). While functional for the stated purpose, the runtime instructions grant the agent broad discretion to obtain and store sensitive credentials and session cookies.
Install Mechanism
No arbitrary remote downloads or custom installers are used. The only external package referenced is twikit via pip (requirements.txt). The skill is distributed as code files (no install spec), which will be executed by the agent — expected but means code runs locally on the agent.
Credentials
The skill does not request platform env vars but expects sensitive secrets in config.json (x_password/x_username or cookies.json). The README explicitly suggests telling the agent your username/password which risks exposing credentials in chat or in files under the agent's skill directory. Storing cookies.json in the skill directory creates persistent session material that other processes or skills could potentially access if the host environment is shared.
Persistence & Privilege
always:false (good). The skill writes cookies and config files into its own directory (normal), and the README suggests installing as a global skill. It does not request to modify other skills or system configs. The combination of agent-run exec plus instructions to auto-install/authenticate increases blast radius if credentials are provided.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install x-cli
  3. After installation, invoke the skill by name or use /x-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: - 40+ commands across 7 scripts (read, search, post, interact, dm, extra, auth). - No API keys needed (cookie auth). - Fully compatible with OpenClaw agents. - Media vision & contextual replies supported.
Metadata
Slug x-cli
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is X-CLI Toolkit?

Full-featured X/Twitter toolkit — read, search, post, interact, DMs, lists, polls, trends. Cookie auth, proxy support, no API keys needed. It is an AI Agent Skill for Claude Code / OpenClaw, with 760 downloads so far.

How do I install X-CLI Toolkit?

Run "/install x-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is X-CLI Toolkit free?

Yes, X-CLI Toolkit is completely free (open-source). You can download, install and use it at no cost.

Which platforms does X-CLI Toolkit support?

X-CLI Toolkit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created X-CLI Toolkit?

It is built and maintained by IGN Software (@ignsoftwarellc); the current version is v1.0.0.

💬 Comments