Repo brief: sferik/twitter-ruby

Generated by RepoPilot · document generated 2026-09-12 · concise human review Evidence snapshot · analyzed 2026-09-12T19:24:39.219Z · commit 4fab71afd8fa

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit 3d ago
• 4 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

A Ruby wrapper for the Twitter API v1.1 that provides object-oriented access to tweets, users, timelines, and direct messages through OAuth-authenticated HTTP requests. It translates Twitter's REST API responses into Ruby model objects (Tweet, User, DirectMessage, etc.) with chainable query methods and automatic rate-limit handling. Flat monolithic gem structure: lib/twitter/ contains model classes (base.rb, entities.rb, client.rb) and domain objects (direct_message.rb, direct_message_event.rb) organized by feature domain. lib/twitter/direct_messages/ and lib/twitter/entity/ subdirectories group related models. Examples in examples/ as markdown files. CI orchestrated via .github/workflows/…

Start here

Open these first:

• lib/twitter.rb — Entry point that loads all Twitter gem modules and sets up the main namespace; every contributor must understand the gem's…
• lib/twitter/client.rb — Core Client class that integrates REST and streaming APIs; the primary interface users interact with and the foundation for…
• lib/twitter/rest/client.rb — REST API client implementation that manages all HTTP request routing and response handling; critical for understanding REST…
• lib/twitter/rest/request.rb — Low-level request abstraction handling authentication, encoding, and HTTP communication; essential for debugging API…
• lib/twitter/factory.rb — Object deserialization factory that transforms raw API responses into Ruby domain objects; key to understanding data…

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/sferik/twitter-ruby.git
cd twitter-ruby
bundle install
bundle exec rspec

Then create a Twitter app at developer.x.com, configure credentials, and try examples from examples/ directory or bin/console REPL.

Daily commands:

bundle exec bin/console
# or run tests:
bundle exec rspec
# or lint:
bundle exec standardrb

The gem is a library, not a runnable app—require it and instantiate Twitter::REST::Client with credentials (see Configuration section in README).

Key cautions & unknowns

• Small team — 4 contributors active in recent commits
• Single-maintainer risk — top contributor 93% of recent commits
• OAuth credentials must be set before instantiating Twitter::REST::Client or calls will fail silently/with 401. The gem targets API v1.1 which is frozen—new Twitter API methods will not be added. Direct message wrapper…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.