agentmods.dev

fli AGENTS.md

A project instruction guide for Fli, a Python library and command-line tool that retrieves Google Flights data. It documents installation, formatting, tests, the command-line tool, the server interface, and release steps.

In plain words
What is it for?
Use it to install dependencies, lint, format, test, run the flight-search tools, start the server interface, and prepare manual releases.
Why use it?
It gives a coding agent the project's normal commands and warns which tests depend on the live Google Flights service and may fail because of rate limits.

Instructions file for CodexOpenCode

3.1k +3 1mo ago A scan 459 tokens original MIT
View the source file punitarani/fli
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/punitarani/fli/agents-md
Clone the repo
git clone --depth 1 https://github.com/punitarani/fli

Made for: Codex, OpenCode.

Per session 459 This file is loaded in full into every session.
When invoked 459 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00459 $0.00459
Opus 5 $0.00230 $0.00230
Sonnet 5 $0.00092 $0.00092
Haiku 4.5 $0.00046 $0.00046

Measured 3d ago against content hash 75400bfc3300, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

fli AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 38 lines

What it actually says

AGENTS.md

Cursor Cloud specific instructions

Overview

Fli is a Python library providing programmatic access to Google Flights data via reverse-engineered API. It offers a CLI (fli), MCP server (fli-mcp / fli-mcp-http), and Python API. No external services (databases, caches, etc.) are required.

Development commands

All standard commands are in the Makefile and CLAUDE.md. Key ones:

  • Install deps: uv sync --all-extras
  • Lint: make lint (ruff)
  • Format: make format
  • Tests: make test (standard), make test-all (including fuzz)
  • CLI: uv run fli flights JFK LAX 2026-05-15
  • MCP HTTP server: uv run fli-mcp-http (serves at http://127.0.0.1:8000/mcp/)

Testing caveats

  • Tests under tests/search/ hit the live Google Flights API and are rate-limited (HTTP 429). These will frequently fail in cloud/CI environments. All other tests (CLI, core, models, MCP) are self-contained and pass reliably.
  • Run uv run pytest -vv --ignore=tests/search/ to skip flaky API-dependent tests.
  • One MCP test (test_search_dates_round_trip) also makes a live API call and may fail with empty results.

Releasing

Releases are manual: GitHub Actions → Release → Run workflow on main, choose bump=patch|minor|major|explicit. Run with dry_run=true first to preview. Bump logic is in scripts/bump_version.py (testable). See the Releasing section in CLAUDE.md and the .github/workflows/release*.yml workflows for the full process.

MCP server notes

  • The MCP HTTP endpoint requires Accept: application/json, text/event-stream header.
  • The fli/server/ module has been removed from the codebase.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 38 lines · 459 tokens per session scan A 75400bfc3300

Subscribe to this mod's changes

fli AGENTS.md is an instructions file published in the GitHub repository punitarani/fli (3,130 stars, last pushed 1mo ago), licensed MIT. It adds 459 tokens to every session, about $0.0023 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

apiflights-apigoogle-flightsgoogle-flights-apimcpmcp-server
Related

Other instructions, from other repositories

anytype-mcp CLAUDE.md

Instructions for anyproto/anytype-mcp, covering claude.md, common commands, development, testing and code quality.

anyproto/anytype-mcp · 742 tokens

apitap CLAUDE.md

Instructions for n1byn1kt/apitap, covering claude.md, using apitap as an mcp tool, commands, architecture and module map.

n1byn1kt/apitap · 1,683 tokens

apitap copilot-instructions.md

Instructions for n1byn1kt/apitap, covering copilot instructions for apitap, build and test commands, high-level architecture and key repository conventions.

n1byn1kt/apitap · 663 tokens

StitchAPI CLAUDE.md

Instructions for rejifald/StitchAPI, covering stitchapi — working agreement for claude, edit in a fresh worktree off main, nodemodules in a fresh worktree and using the stitchapi docs mcp.

rejifald/StitchAPI · 738 tokens

FFBB-MCP-Server AGENTS.md

Instructions for nickdesi/FFBB-MCP-Server, covering ffbb mcp server, langue, persona, workflow ffbb (outils mcp) and ressources mcp.

nickdesi/FFBB-MCP-Server · 3,823 tokens

nightlife-mcp CLAUDE.md

Instructions for alcylu/nightlife-mcp, covering nightlife-mcp — technical spec, running, stdio (local claude desktop), http (remote clients) and production.

alcylu/nightlife-mcp · 5,032 tokens