# twitter/twurl

OAuth-enabled curl for the Twitter API

Repository: https://github.com/twitter/twurl
Canonical: https://ross.abutalabs.com/products/twurl
Homepage: https://developer.twitter.com
Language: Ruby
License: MIT
License Family: permissive
Topics: twitter, twitter-api, ruby, curl, cli, twurl
Last push: 2023-07-20T20:54:51+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 6163, "days_push": 1140, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1800, forks 296 (observed 2026-08-28T04:05:37.936959+00:00)

## What it is
Twurl is a Ruby-based command-line tool that acts like curl but is tailored specifically for the Twitter API, handling OAuth authorization and request signing. It supports multiple access tokens, bearer token authentication, and aliases for common requests.

## Use cases
- make authenticated requests to the Twitter API from the command line
- authorize a Twitter app and generate access tokens via OAuth
- test Twitter API endpoints without writing code
- switch between multiple Twitter accounts and client apps
- generate and use bearer tokens for application-only auth
- debug Twitter API responses like curl

## When to choose
- you need a quick CLI way to explore or debug the Twitter API
- you want OAuth signing handled for you instead of manually computing signatures
- you manage multiple Twitter apps or accounts and need to switch tokens easily

## When to avoid
- you need a full-featured Twitter client library for an application rather than a debugging tool
- you are not working with the Twitter API
- you need a GUI or non-command-line workflow

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: http-client, auth, cli, developer-tools
- domain: developer-tools, apis, social-media
- platform: cli, cross-platform, ruby
- tags: twitter-api, oauth, curl, api-debugging, command-line

## Member repositories
- twitter/twurl (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:37.936959+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:22:15.354356+00:00, confidence not recorded.
  - readme: https://github.com/twitter/twurl (fetched 2026-08-28T04:05:37.936959+00:00, sha f02213c05deb)
  - homepage: https://developer.twitter.com (fetched 2026-08-29T11:01:01.455457+00:00, sha 7783569dda8f)
- Data as of 2026-08-30T08:39:29.467469+00:00.