Driftless

Driftless is a documentation automation tool built for developers who want their README files to stay accurate as their codebase evolves. Created by Het Limbachiya, it connects to GitHub via OAuth, reads your actual file tree, package.json, environment configs, and CI workflows, then uses AI to generate a grounded README — and opens a pull request automatically. A free "Roast My README" tool lets anyone grade any public repo without signing in.

What It Is

Driftless sits in the category of AI-powered documentation generators with a specific focus on README accuracy and drift prevention. Unlike generic AI writing tools, it reads real project artifacts — dependencies, environment variables, routes, Dockerfiles, GitHub Actions configs — and generates documentation grounded only in what it actually finds. The core workflow is: connect repo → AI generates README → Driftless opens a GitHub PR with the result. A secondary capability, drift detection, re-analyzes repos over time and scores how stale the README has become relative to the current code.

How the Workflow Works

The three-step flow is designed to go from a connected repo to a merged PR in under 60 seconds:

• Connect: OAuth with GitHub; Driftless fetches the file tree, manifest, env config, and CI workflows
• Generate: AI produces a structured README using only data it actually found — no invented features, no hallucinated tech stack
• Ship: Driftless creates a branch, commits the README, and opens a GitHub PR with a pre-written title and description

The tool claims zero hallucinations by grounding every generated line in real code artifacts rather than repo descriptions or user-supplied text.

Key Features

• Roast My README: Free, no-login tool that grades any public GitHub repo's README and returns specific, actionable issues with a letter grade
• Smart Code Analysis: Reads package.json, .env.example, route files, and CI configs to detect the actual stack
• Accurate README Generation: Produces exact install commands, real dependency lists, and actual API routes
• Auto PR Creation: One-click branch creation, commit, and pull request opening on GitHub
• Doc Drift Detection: Scores README staleness over time with a history chart to track trends
• Docs CI GitHub Action: Adds a drift check to every push; fails CI if the README score drops below a configured threshold

Target Audience and Deployment Model

Driftless targets individual developers, open-source maintainers, DevRel engineers, and engineering teams who ship frequently and find README maintenance a low-priority chore. It is a web-based SaaS accessed via GitHub OAuth — no local installation is required for the core generate-and-PR workflow. The Docs CI GitHub Action is an optional add-on for teams that want drift enforcement baked into their CI pipeline. The Team plan adds a GitHub App for automatic drift detection on every push, a PR comment bot, and an org-level dashboard.

Current Status

Driftless is actively available at driftlessx.dev with a free tier, a Pro plan, and a Team plan. The site advertises a 7-day Pro trial with no charge if cancelled before day 7. The homepage lists a changelog link (currently a placeholder anchor) and the footer copyright reads 2026, suggesting the product is in early active development. The contact page lists a direct email for bug reports and feedback, with a stated 24-hour response time.