git404hub

what is ramp-autofill fr?

kothari-nikunj/ramp-autofill — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · ops devopsComplexity · 4/5Setup · hard

tl;dr

A Claude Code skill that automatically categorizes Ramp card transactions, finds and attaches matching receipts from iMessage and Gmail, and flags anything it cannot confidently complete.

vibe map

vibe map loading… check back in a sec.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically fill in missing category, memo, and receipt information for Ramp card transactions.

VIBE 2

Search iMessage and Gmail for a matching receipt and attach it as a rendered PDF.

VIBE 3

Run a weekly scheduled sweep so new company card spend stays coded within days.

VIBE 4

Flag any transaction where the receipt, category, or memo cannot be confidently determined instead of guessing.

what's the stack?

PythonClaude CodePlaywrightRamp CLI

how it stacks up fr

kothari-nikunj/ramp-autofill0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity4/52/52/5
Audienceops devopsgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires an authenticated Ramp CLI account plus Gmail and Google Calendar MCP connectors configured in Claude Code.

The README does not state a license.

in plain english

ramp-autofill is a Claude Code skill that cleans up your Ramp company card transactions automatically. For every transaction it makes sure the category, memo, and receipt are filled in where Ramp requires them, or it explicitly flags the transaction with a reason if it cannot be completed safely. Nothing is silently ignored, every transaction ends up in one of three buckets: already complete, completed during this run, or flagged for you to look at. It finds receipts by searching iMessage for receipt links and searching Gmail, then renders whatever it finds locally into a PDF using a headless browser before attaching it. The safety rules are built into the code itself rather than just suggested in a prompt, so they hold even if something goes wrong elsewhere. Only a small allowlisted set of Ramp commands can ever run, actions like approving payments or moving funds are not in that list at all. The tool also refuses to overwrite a transaction that already has a memo, category, or receipt, and it only attaches a receipt when the amount, date, and merchant plausibly match, otherwise it flags the transaction instead of guessing. The process runs in phases: it first learns your personal categorization style from past transactions, then fetches and sorts transactions by what they need, searches for receipts, has separate passes judge the categorization, memo wording, and receipt matches, and finally writes the results according to whichever automation mode you have chosen. There are four modes, ranging from report only, which changes nothing, up to full auto, which writes both high and medium confidence results without pausing for approval, though low confidence items are never written automatically in any mode. Everything runs on your own machine using the Ramp CLI, Claude Code, and connectors for Gmail and Google Calendar, with no remote services involved.

prompts (copy fr)

prompt 1
Help me set up ramp-autofill by running preflight.py and connecting the Ramp CLI, Gmail, and Calendar.
prompt 2
Walk me through the first-run style setup so ramp-autofill learns how I categorize transactions.
prompt 3
Explain the difference between report_only, gated, auto_high_confidence, and full_auto automation modes.
prompt 4
Show me how to schedule a weekly run of the ramp-autofill skill using cron or Claude Code scheduled agents.

Frequently asked questions

what is ramp-autofill fr?

A Claude Code skill that automatically categorizes Ramp card transactions, finds and attaches matching receipts from iMessage and Gmail, and flags anything it cannot confidently complete.

What language is ramp-autofill written in?

Mainly Python. The stack also includes Python, Claude Code, Playwright.

What license does ramp-autofill use?

The README does not state a license.

How hard is ramp-autofill to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ramp-autofill for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.