{"id":25925239,"url":"https://github.com/bigsk1/x-terminal","last_synced_at":"2026-06-06T12:31:25.957Z","repository":{"id":279011412,"uuid":"937470791","full_name":"bigsk1/x-terminal","owner":"bigsk1","description":"In your terminal manage X posts - tweet, reply, delete, image uploads","archived":false,"fork":false,"pushed_at":"2025-02-24T05:23:16.000Z","size":276,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-07T17:58:56.145Z","etag":null,"topics":["linux","python","python-script","script","terminal-based","twitter-api","windows","x-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bigsk1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"bigsk1"}},"created_at":"2025-02-23T06:01:30.000Z","updated_at":"2025-02-24T05:23:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"d929d172-dd5e-4e91-865a-8118b69185ff","html_url":"https://github.com/bigsk1/x-terminal","commit_stats":null,"previous_names":["bigsk1/x-terminal"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bigsk1/x-terminal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fx-terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fx-terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fx-terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fx-terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigsk1","download_url":"https://codeload.github.com/bigsk1/x-terminal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fx-terminal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33983046,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","python","python-script","script","terminal-based","twitter-api","windows","x-api"],"created_at":"2025-03-03T18:40:26.638Z","updated_at":"2026-06-06T12:31:25.952Z","avatar_url":"https://github.com/bigsk1.png","language":"Python","funding_links":["https://github.com/sponsors/bigsk1"],"categories":[],"sub_categories":[],"readme":"# X Terminal \n\n\nA tool to manage X posts - tweet, reply, delete, image uploads (e.g., Cloudflare Images). Python 3.10+, Windows and Linux\n\n\n![xt](xt.png)\n\nGet X Dev account is free\nhttps://developer.x.com/\n\n## Setup Instructions\n\n### Install Dependencies\n```sh\npip install requests requests-oauthlib rich\n```\n\n### Set Environment Variables (e.g., in `.zshrc` or `.bashrc`)\n```sh\nexport X_CONSUMER_KEY=\"your_key\"\nexport X_CONSUMER_SECRET=\"your_secret\"\nexport X_ACCESS_TOKEN=\"your_token\"\nexport X_ACCESS_TOKEN_SECRET=\"your_token_secret\"\n```\n\n### Apply Changes\n```sh\nsource ~/.zshrc\n```\n\n\n## General Usage\n```sh\npython x.py [global_options] \u003ccommand\u003e [command_options]\n```\n\n### Global Options\nThese can be used with any command:\n\n- `--verbose`  \n  - **Description:** Expose raw data streams from the X matrix (e.g., API responses) for debugging.  \n  - **Example:**  \n    ```sh\n    python x.py post \"Test\" --verbose\n    ```\n  - **Output:** Shows detailed JSON responses from API calls.\n\n- `--help` or `-h`  \n  - **Description:** Display the full help menu with setup instructions and examples.  \n  - **Example:**  \n    ```sh\n    python x.py --help\n    ```\n  - **Output:** Lists all commands, options, and setup steps.\n\n---\n\n## Commands and Their Options\n\n### `post`\nTransmit a message or thread into X cyberspace, with optional image or reply.\n\n#### Usage\n```sh\npython x.py post \"message\" [options]\n```\n\n#### Options\n- **message (required)**  \n  - **Description:** The data packet to transmit (supports emojis).  \n  - **Example:** `\"Testing the grid! 😊\"`\n\n- `-i` or `--image-url`  \n  - **Description:** URL of a visual payload (e.g., Cloudflare Image URL).  \n  - **Example:**  \n    ```sh\n    --image-url https://imagedelivery.net/.../public\n    ```\n  - **Note:** Works with URLs lacking extensions if they serve images (checked via content-type).\n\n- `--reply-to`  \n  - **Description:** Target tweet ID to reply to in the grid.  \n  - **Example:**  \n    ```sh\n    --reply-to 1893520325645861269\n    ```\n\n- `--dry-run`  \n  - **Description:** Simulate transmission without sending to X (preview only).  \n  - **Example:**  \n    ```sh\n    --dry-run\n    ```\n  - **Output:** Shows tweet fragments and image URL without posting.\n\n#### Examples\n```sh\n# Simple post\npython x.py post \"Hello cyberspace!\"\n\n# With image only\npython x.py post \"🖼️\" -i https://imagedelivery.net/WfhVb8dSNAAvdXUdMfBuPQ/695bc126-614d-4571-908d-5a5173127100/public\n\n# Thread preview - dry run doesn't send\npython x.py post \"This is a long message that will split into multiple parts...\" --dry-run\n\n# Reply to post\npython x.py post \"Hey World\" --reply-to 1893572351994019980\n\n# Reply to post with message and image\npython x.py post \"Hey World\" --reply-to 1893572351994019980 -i https://imagedelivery.net/WfhVb8dSNAAvdXUdMfBuPQ/695bc126-614d-4571-908d-5a5173127100/public\n\n# Delete post\npython x.py delete 1893529363959947744\n```\n\n![xt2](xt2.png)\n\n---\n\n### `delete`\nPurge a tweet from the X matrix by its ID.\n\n#### Usage\n```sh\npython x.py delete \u003ctweet_id\u003e [options]\n```\n\n#### Options\n- **tweet_id (required)**  \n  - **Description:** The ID of the tweet to erase.  \n  - **Example:** `1893529363959947744`\n\n- `--no-confirm`  \n  - **Description:** Bypass the confirmation prompt for deletion.  \n  - **Example:**  \n    ```sh\n    --no-confirm\n    ```\n  - **Default:** Prompts `\"Confirm purge of tweet \u003cid\u003e? [y/N]\"`\n\n#### Examples\n```sh\n# With prompt\npython x.py delete 1893529363959947744\n\n# No prompt\npython x.py delete 1893529363959947744 --no-confirm\n```\n\n---\n\n### `version`\nReveal the cyberdeck’s version.\n\n#### Usage\n```sh\npython x.py version\n```\n\n#### Options\nNone\n\n#### Example\n```sh\npython x.py version\n```\n**Output:** `X CLI Cyberdeck version 1.3.0-cyberpunk`\n\n---\n\n\n## Notes\n- **Image URLs:** Compatible with Cloudflare Image URLs (e.g., `https://imagedelivery.net/.../public`) as long as they return an `image/*` content-type.\n- **Threads:** Messages longer than 280 characters are automatically split into a thread, with images attached to the first tweet.\n- **Cyberpunk Theme:** Terminal output uses neon colors (cyan, magenta, green) and futuristic terms like \"matrix\" and \"transmission.\"\n- **Windows:** For best emoji support (e.g., 😊), use Windows Terminal; a warning appears otherwise.\n\n---\n\n## Example Usage Scenarios\n\n### Post with Cloudflare Image\n```sh\npython x.py post \"Cyberpunk terminal test\" --image-url https://imagedelivery.net/WfhVb8dSNAAvdXUdMfBuPQ/8a36640e-0d4d-4753-f269-77d3b5946200/public\n```\n\n### Delete a Tweet\n```sh\npython x.py delete 1893529363959947744\n```\n\n### Check Version\n```sh\npython x.py version\n```\n\n![xt3](xt3.png)\n\n\n [![Follow on X](https://img.shields.io/badge/follow-%40bigsk1_com-1DA1F2?style=for-the-badge\u0026logo=x\u0026logoColor=white)](https://x.com/bigsk1_com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigsk1%2Fx-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigsk1%2Fx-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigsk1%2Fx-terminal/lists"}