twexapi-cli

Use this skill when the task should be completed by running twexapi commands instead of re-implementing request logic by hand.

Use this skill when

• - the user wants to install or run the twexapi CLI
• the user wants to configure an API key, cookie, or INLINECODE2
• the user wants to test or inspect requests with INLINECODE3
• the user wants to call supported twexapi commands for users, tweets, search, followers, following, lists, or follow actions
• the user knows an endpoint path and wants to call it through the generic twexapi <path> form

Do not treat this skill as the main interface when the task is to edit the CLI source code itself.

Default approach

1. 1. Confirm the CLI is available.
2. Make sure an app config or API key is available for read requests.
3. Make sure a saved profile or explicit cookie is available for write requests.
4. Prefer convenience commands first.
5. Fall back to twexapi <path> only when no convenience command fits.
6. Use --dry-run before real write actions unless the user explicitly asks to execute them.

Install and run

For normal users, prefer the published npm package:

CODEBLOCK0

When working from this repository:

CODEBLOCK1

If a local executable is needed while developing:

CODEBLOCK2

Requires Node.js 18 or newer.

Auth rules

• - API keys come from https://twexapi.io/dashboard.
• For one-off commands, TWEXAPI_KEY or --api-key is acceptable.
• The CLI also respects TWEXAPI_BASE_URL and TWEXAPI_CONFIG_DIR.
• For repeated usage, prefer saved app configs with auth apps add.
• For write actions, require either --cookie or a saved profile.
• If a write action is requested without a usable profile or cookie, stop and ask for auth details instead of guessing.
• By default the CLI reads and writes persistent config in ~/.twexapi/config.json.
• Saved app configs may include API keys, and saved profiles may include cookies, auth_token, or ct0 in plain JSON.
• On shared machines or CI, prefer --config-dir or TWEXAPI_CONFIG_DIR to isolate credentials.

App setup:

CODEBLOCK3

Profile setup from cookie:

CODEBLOCK4

Profile setup from auth token:

CODEBLOCK5

Inspect config:

CODEBLOCK6

Command selection

Prefer convenience commands such as:

CODEBLOCK7

Use the generic path form when the endpoint is known but not wrapped:

CODEBLOCK8

Safety and execution rules

• - Put global options such as --app, --profile, --api-key, and --dry-run before the command.
• For write actions like tweet create, tweet like, user follow, and list create, prefer --dry-run first.
• Only send the real write request after the user clearly wants execution.
• The CLI masks secrets in config output and dry-run previews, but still avoid echoing raw credentials back to the user.
• INLINECODE28 uses a request path that contains the auth_token, so be careful with logs and traces.
• Local media file upload is not implemented; tweet creation supports --media-url.
• DM commands are not included.

Recommended test flow

Use an isolated config directory for local testing:

CODEBLOCK9

Recommended order:

1. 1. Verify the CLI starts with twexapi --help or node ./bin/twexapi.js --help.
2. Verify a read command such as about or users.
3. Verify a raw-path request if needed.
4. Verify write-command request construction with --dry-run before any real write action.