← Back to Skills Marketplace

Fuel CLI

Name: Fuel CLI
Author: shan8851

by shan8851 · GitHub ↗ · v0.1.0 · MIT-0

cross-platform ✓ Security Clean

110

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install fuel-cli

Description

UK fuel prices CLI — find nearby stations by postcode or coordinates, get station details, ranked by price/distance/freshness, and agent-friendly JSON envelo...

README (SKILL.md)

fuel-cli

Use fuel for UK fuel prices: nearby station search, station detail, ranked results with freshness tracking.

Setup

npm install -g @shan8851/fuel-cli
Register at https://www.fuel-finder.service.gov.uk for Fuel Finder OAuth credentials
export FUEL_FINDER_CLIENT_ID=*** and export FUEL_FINDER_CLIENT_SECRET=*** or add to .env
Warm cache reads work without credentials until the cache needs a refresh

Nearby Stations

By postcode: fuel near "SE1 9SG" --fuel E10
By coordinates: fuel near "51.501,-0.141" --fuel B7_STANDARD
Custom radius: fuel near "SE1 9SG" --fuel E10 --radius 8mi
Sort options: fuel near "SE1 9SG" --fuel E10 --sort price (best, price, distance, freshest)
Limit results: fuel near "SE1 9SG" --fuel E10 --limit 5
Force refresh: fuel near "SE1 9SG" --fuel E10 --refresh

Station Detail

By name: fuel station "tesco watford"
By node ID: fuel station "\x3Cnode-id>"
Project one field: fuel station "\x3Cnode-id>" --output station.prices.0.pencePerLitre
Project subtree: fuel station "\x3Cnode-id>" --output station.openingTimes

Fuel Types

E10 — E10 unleaded petrol
E5 — Super unleaded petrol
B7_STANDARD — Standard diesel
B7_PREMIUM — Premium diesel
B10 — B10 biodiesel
HVO — HVO diesel

Output

Defaults to text in a TTY and JSON when piped
Force JSON: fuel near "SE1 9SG" --fuel E10 --json
Force text: fuel near "SE1 9SG" --fuel E10 --text
Disable colour: fuel --no-color near "SE1 9SG" --fuel E10
Success envelope: { ok, schemaVersion, command, requestedAt, data }
Error envelope: { ok, schemaVersion, command, requestedAt, error }

Agent Notes

--fuel is required on near — petrol and diesel are never mixed in one ranking
--output \x3Cpath> is available on both near and station
Paths use dot notation with zero-based array indexes, for example stations.0.selectedPricePencePerLitre or station.prices.0.pencePerLitre
In text mode, scalar projections print just the value; object or array projections print plain JSON
Projection errors are structured: malformed paths return INVALID_INPUT, missing paths return NOT_FOUND
Data-quality advisories live under data.quality.advisories — warn about stale prices, missing timestamps, and excluded test stations
data.quality.freshnessCounts breaks down fresh/aging/stale/unknown price counts
Likely test/demo forecourts are excluded automatically when normal stations exist; count is in data.quality.excludedLikelyTestStations

Configuration

FUEL_FINDER_CLIENT_ID — required for live data (free registration)
FUEL_FINDER_CLIENT_SECRET — required for live data
FUEL_FINDER_BASE_URL — optional, defaults to https://www.fuel-finder.service.gov.uk
FUEL_CACHE_DIR — optional, override cache location (defaults to platform cache dir)

Notes

near requires --fuel so petrol and diesel results are never mixed
Accepts UK postcodes (SE1 9SG) and coordinates (51.501,-0.141)
Radius accepts unitless (miles) or with mi/km suffix
Persistent local cache for station and price data — works offline until cache expires
Prices include freshness bands (fresh \x3C 30min, aging \x3C 24h, stale > 24h, unknown)
Exit codes: 0 success, 2 bad input or ambiguity, 3 upstream failure, 4 internal error
When a station query is ambiguous, the error includes candidate suggestions with brand, address, postcode, and node ID

Usage Guidance

This skill appears to do what it says: a CLI that queries UK Fuel Finder data and requires Fuel Finder OAuth credentials. Before installing: 1) Verify the npm package (@shan8851/fuel-cli) and its source repository (look for a reputable GitHub repo, commit history, and matching homepage) to ensure the published package matches the source. 2) Avoid committing FUEL_FINDER_CLIENT_SECRET to version control or public .env files; store secrets in a secure credential store and rotate them if exposed. 3) If you prefer reduced risk, inspect the package contents or run it in an isolated environment (container or VM) before installing globally. 4) If the government provides an official client, prefer that over third-party packages.

Capability Analysis

Type: OpenClaw Skill Name: fuel-cli Version: 0.1.0 The fuel-cli skill bundle provides a legitimate interface for querying UK fuel prices using the official government Fuel Finder API. It requires standard OAuth credentials (FUEL_FINDER_CLIENT_ID/SECRET) and includes detailed instructions for the agent to handle structured JSON output and data-quality advisories. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found in SKILL.md or _meta.json.

Capability Tags

requires-oauth-tokenrequires-sensitive-credentials

Capability Assessment

✓ Purpose & Capability

Name/description, required binary ('fuel'), required env vars (FUEL_FINDER_CLIENT_ID, FUEL_FINDER_CLIENT_SECRET), and the install spec (npm @shan8851/fuel-cli) are coherent: a client ID/secret for the Fuel Finder API is expected for live queries.

✓ Instruction Scope

SKILL.md instructs only to install the CLI, set OAuth env vars, and run the 'fuel' commands. It does not direct the agent to read unrelated files or exfiltrate data. It does mention storing credentials in a .env file and optional env vars (FUEL_FINDER_BASE_URL, FUEL_CACHE_DIR) that are reasonable for configuration.

ℹ Install Mechanism

Install uses an npm package that creates the 'fuel' binary (expected). Npm installs carry moderate risk compared with no-install skills; the package owner (@shan8851) and homepage (fuel-cli.xyz) are not verified in this manifest — you should confirm the package's provenance, inspect its repository, and prefer official or well-known sources where possible.

✓ Credentials

Requested environment variables are proportional: client ID and secret for the Fuel Finder service are needed for live data. The SKILL.md also documents optional env vars (base URL, cache dir); these are reasonable. No unrelated credentials or broad system secrets are requested.

✓ Persistence & Privilege

Skill is not always-enabled and can be invoked by the user; it does not request elevated persistence or modify other skills. The CLI uses a local persistent cache, which is documented and expected for offline/warm-cache behavior.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install fuel-cli
After installation, invoke the skill by name or use /fuel-cli
Provide required inputs per the skill's parameter spec and get structured output

Version History

v0.1.0

Initial publish with OpenClaw metadata

Metadata

Slug fuel-cli

Version 0.1.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Fuel CLI?

UK fuel prices CLI — find nearby stations by postcode or coordinates, get station details, ranked by price/distance/freshness, and agent-friendly JSON envelo... It is an AI Agent Skill for Claude Code / OpenClaw, with 110 downloads so far.

How do I install Fuel CLI?

Run "/install fuel-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Fuel CLI free?

Yes, Fuel CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Fuel CLI support?

Fuel CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Fuel CLI?

It is built and maintained by shan8851 (@shan8851); the current version is v0.1.0.

More Skills