frugal plugin

A plugin that reminds the agent of free-tier limits and paid traps in cloud services before deploys, without blocking any command.

  • 113 ★ on the repository
  • Last commit
  • MIT
Plugin

Minimal access

Why this level

  • Plugin hooks read the text of executed shell commands to detect the provider.
All reasons and checks

yuanbop/frugal

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add plugins/frugal

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • Plugin hooks read the text of executed shell commands to detect the provider.

This is third-party code. Review the repository files before installing.

What it does

frugal tracks the cloud spending an agent switches on along the way: Vercel, Cloudflare, Neon, Railway, Fly.io, Supabase, GitHub Actions, AWS, GCP, Azure and more. At session start the plugin adds short rules to the context, and before commands such as `vercel` or `wrangler r2` it adds a line with free-tier limits and the main trap. The `quiet`, `normal` and `strict` levels set how loud reminders are. The `/frugal` command shows a cheat sheet and runs a spend audit. The author collected the data in July 2026 from official pricing pages.

Who it is for. Developers and non-technical builders who let an agent deploy and fear a surprise bill at month end.

Good fit when

  • An agent deploys a project to Vercel or Cloudflare for the first time.
  • It pushes to a repository with GitHub Actions workflows on macOS runners.
  • A user with no experience vibe-codes and does not read pricing.
  • An agent creates a database or sandbox that must be torn down afterwards.

Not a fit when

  • You need a hard spending cap, since the plugin only warns.
  • You need pricing for a provider outside the coverage list.
  • You need protection against key leaks or fraud.

Example request

Deploy this project to Vercel and, before running, tell me the free-tier limits and the paid traps ahead.

Limitations

Pricing figures were gathered in July 2026 and age quickly because providers change terms every quarter, so keep the plugin updated. It does not block commands or set limits in clouds, it only advises. Client support varies: Gemini CLI loads `AGENTS.md` and grok has no lifecycle hooks. Pricing data covers a limited list of providers and the plugin knows no other clouds. Reminders add about 1.7 KB of rules to every session's context, which matters under a tight limit.

How to disable. Run `/frugal off` to silence reminders or remove the plugin through `/plugin`. The persistent level lives in `~/.config/frugal/config.json`.

FAQ

Does the plugin block dangerous commands?

No. It adds a warning once per provider per session and never stops a command.

How do I change the volume?

Use `/frugal quiet`, `normal` or `strict`. A persistent level comes from `/frugal default <level>` or the `FRUGAL_MODE` variable.

Which clients does it work with?

Claude Code, Codex, GitHub Copilot CLI, Gemini CLI, OpenCode, Cursor, Windsurf, Cline, Kiro and others. The rules are shared and each client has its own install.

What counts as a paid resource?

Anything that builds up a bill after launch: databases, sandboxes, CI runners. The plugin writes one line about a declared resource and asks to tear down temporary ones.

Is it enough for non-technical users?

The `strict` mode adds real-bill context and asks to confirm risky actions. Experienced users fit `quiet` and `normal`.

Discussion

No questions or reviews yet.

Plugins

Preflight by New Relic: observability for coding agents with cost in USD, efficiency scores and a local dashboard

CLIExtended access67Repository stars
Editors’ pick

Cloudflare's official agent skills: Workers, Durable Objects, wrangler, Pages, storage and an MCP server

PluginExtended access3.4KRepository stars

Plugin with one skill: the agent prepares a project, deploys a container to the Cloudish cloud and returns the live URL.

PluginExtended access140Repository stars

A Herdr plugin with a limits pane: context fill, prompt cache and remaining subscription allowance for each agent.

PluginExtended access66Repository stars

neckbeard turns an app repo into cloud infrastructure built from tested OpenTofu modules, with the monthly bill priced up front

PluginExtended access278Repository stars
Official

Diffinery plugins connect Claude Code and Codex to self-hosted Git, pull requests and CI on Cloudflare through an MCP server

PluginBroad access81Repository stars

README in short

Models remember outdated pricing, so the plugin keeps current numbers in the repository and injects them into the session and before cloud commands. It never blocks work.

README badge

Report a problem