Repo brief: defunkt/gist

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T19:37:48.250Z · commit 232b69cad8a3

Verdict

Mixed — Stale — last commit 4y ago

• 29+ active contributors
• MIT licensed
• Tests present

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

What it is

A command-line tool written in Ruby that uploads code snippets to GitHub Gist (https://gist.github.com) directly from your terminal. It supports uploading single or multiple files, reading from STDIN, clipboard paste, private gists, descriptions, updates to existing gists, and opening results in browsers. The core feature is a thin but feature-rich CLI wrapper around the GitHub Gist API with OAuth device-code flow authentication. Simple single-gem structure: lib/gist.rb is the main library, bin/gist is the CLI entry point, spec/ contains unit tests for auth, clipboard, GHE, proxies, and rawify operations, and vendor/json.rb vendors a JSON library for dependency minimization. The…

Start here

Open these first:

• lib/gist.rb — Core library containing all gist upload logic, authentication, API communication, and CLI argument parsing—every…
• bin/gist — Command-line executable entry point that invokes the Gist class; essential for understanding how CLI commands are routed.
• gist.gemspec — Gem specification defining dependencies and metadata; critical for build and distribution.
• spec/gist_spec.rb — Primary test suite covering the core Gist class behavior; essential for validating changes to lib/gist.rb.
• README.md — Complete usage documentation and feature reference; defines expected behavior and user-facing API.

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/defunkt/gist.git
cd gist
bundle install
bin/gist --help

Daily commands:

bundle install
bin/gist --help              # Show all options
gist -c file.rb            # Upload file and copy URL
gist -P                     # Paste from clipboard
gist --login               # Start OAuth device-code flow

Key cautions & unknowns

• Stale — last commit 4y ago
• Concentrated ownership — top contributor handles 54% of recent commits
• GitHub API token storage: auth tokens are stored plaintext in ~/.gist file—ensure proper file permissions (mode 600) to prevent token leakage. Environment variables: GIST_CLIENT_ID and…
• 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.