Initial commit: twitter-cli for posting tweets via GraphQL API

Features: - Post tweets and replies via Twitter GraphQL API - Cookie extraction from Chrome (macOS) - Env var and CLI argument authentication - 19 passing tests with vitest - Biome for linting
2025-11-28 06:35:17 +00:00
parent e9f34afab0
commit 011476f607
14 changed files with 2411 additions and 0 deletions
@@ -0,0 +1,86 @@
+# twitter-cli
+
+A command-line tool for posting tweets and replies via Twitter's GraphQL API.
+
+## Installation
+
+```bash
+cd ~/Projects/twitter-cli
+pnpm install
+```
+
+## Usage
+
+### Post a tweet
+
+```bash
+./twitter-cli tweet "Hello from twitter-cli!"
+```
+
+### Reply to a tweet
+
+```bash
+# Using tweet URL
+./twitter-cli reply "https://x.com/user/status/1234567890" "This is my reply"
+
+# Using tweet ID directly
+./twitter-cli reply 1234567890 "This is my reply"
+```
+
+### Check credentials
+
+```bash
+./twitter-cli check
+```
+
+## Authentication
+
+The tool resolves credentials in the following order of priority:
+
+1. **CLI arguments** (highest priority)
+   ```bash
+   ./twitter-cli --auth-token "xxx" --ct0 "yyy" tweet "Hello"
+   ```
+
+2. **Environment variables**
+   ```bash
+   export AUTH_TOKEN="xxx"
+   export CT0="yyy"
+   ./twitter-cli tweet "Hello"
+   ```
+
+   Alternative env var names: `TWITTER_AUTH_TOKEN`, `TWITTER_CT0`
+
+3. **Chrome cookies** (fallback - macOS only)
+   - Automatically extracts from Chrome's cookie database
+   - Requires Chrome to be logged into x.com
+   - May prompt for keychain access on first run
+
+### Getting Your Cookies
+
+1. Open Chrome and log into x.com
+2. Open DevTools (Cmd+Option+I)
+3. Go to Application > Cookies > x.com
+4. Copy the values for `auth_token` and `ct0`
+
+## Development
+
+```bash
+# Run in development mode
+pnpm run dev tweet "Test"
+
+# Run tests
+pnpm test
+
+# Run linter
+pnpm run lint
+
+# Fix lint issues
+pnpm run lint:fix
+```
+
+## Notes
+
+- Chrome cookie extraction requires macOS (uses `sqlite3` and `security` CLI tools)
+- The keychain access may block when running over SSH - use env vars instead
+- Twitter may rotate GraphQL query IDs - update `src/lib/twitter-client.ts` if needed