final-pos-mcp GEMINI.md

final-pos-mcp GEMINI.md is an instructions file for Gemini CLI from Final-Commerce/final-pos-mcp. It costs 789 tokens per session, scanned A, original, Apache-2.0.

A set of Gemini CLI instructions for building Final POS apps with Final's build and documentation services. POS means point-of-sale software used for purchases, payments, kiosks, self-checkout, and related in-person experiences.

In plain words
What is it for?
Use it when creating or continuing Final apps for registers, kiosks, self-checkout, kitchen displays, payment terminals, line-busting, or menu boards.
Why use it?
It explains the required build sequence and project rules, helping prevent incorrect app setup and keeping changes connected to the user's Final builder project.

Instructions file for Gemini CLI

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/final-commerce/final-pos-mcp/gemini-md
Clone the repo
git clone --depth 1 https://github.com/Final-Commerce/final-pos-mcp

Made for: Gemini CLI.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for final-pos-mcp GEMINI.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/final-commerce/final-pos-mcp/gemini-md.svg)](https://agentmods.dev/instructions/final-commerce/final-pos-mcp/gemini-md)
Your own site
<a href="https://agentmods.dev/instructions/final-commerce/final-pos-mcp/gemini-md"><img src="https://agentmods.dev/badge/instructions/final-commerce/final-pos-mcp/gemini-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 789 This file is loaded in full into every session.
When invoked 789 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.00789 $0.00789
Opus 5 $0.00394 $0.00394
Sonnet 5 $0.00158 $0.00158
Haiku 4.5 $0.00079 $0.00079

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

Security

Grade A, and why

final-pos-mcp GEMINI.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.

GEMINI.md · 61 lines

How it starts

The opening of the file, as written. The whole thing — 61 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Building Final POS apps

You are connected to the Final Flows MCP server (final-flows), the build API for Final — a platform for creating custom point of sale, kiosk, self-checkout, KDS, and in-person payment apps that run on any hardware (desktop, tablet, mobile, payment terminal, line buster, menu board). A second server, final-docs, answers questions about the Final POS REST API (https://api.finalpos.com).

Everything you do through final-flows shows up live in the user's builder at build.finalpos.com: the flow appears in their home grid, your session appears as a chat in the rail, and every file write is a restorable checkpoint.

The build loop

Follow this order for every POS app you build:

  1. get_scaffold — call once per session to learn the app contract: engine-owned files (never write them), the baseline package.json, and the construction rules.
  2. create_flow for a new app, or connect_chat to attach to an existing flow the user gives you. Never create a new flow when the user already has one.
  3. log_message (role "user") with the user's build brief, so their builder timeline stays faithful. Log short assistant notes at milestones.
  4. Ground before you write. Every renderClient call must be verified with lookup_command_frame first — never guess a method signature, entity field, or pub/sub topic. Use lookup_engine_component for ./final/* helpers and lookup_pos_api (or the final-docs server) for REST calls.
  5. Start from blueprints. Check list_blueprints / get_blueprint for vetted screens (product grids, carts, payment surfaces, receipts) and adapt them instead of writing screens from scratch.
  6. write_flow_files with full file contents. App code lives under src/, entry point src/App.tsx. Writes to engine-owned paths are rejected.
  7. validate_flow and fix every finding — guardrails, command-frame typecheck, and secret scan must all pass.
  8. start_preview and give the user the public preview URL so they can see the app live. Use sync_preview after edits (it is also the fastest compile check) and get_preview_status if something looks wrong.

Read the full file on GitHub · 61 lines

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 · 61 lines · 789 tokens per session scan A b0ad7f40ae13

Subscribe to this mod's changes

final-pos-mcp GEMINI.md is an instructions file published in the GitHub repository Final-Commerce/final-pos-mcp (0 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 789 tokens to every session, about $0.0039 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-31.

Related

Other instructions, from other repositories

gemini-extension GEMINI.md

Instructions for conversiontools/gemini-extension, covering conversion tools, if the tools are not available, how to convert a file, build a custom converter (ai studio) and tip: prefer the ctio cli when available.

conversiontools/gemini-extension · 990 tokens

meteocontrol-mcp GEMINI.md

Gemini CLI instructions for nielsvbrecht/meteocontrol-mcp, covering meteocontrol extension context, core mandates & communication style, operational guidelines, 1. performance analysis & metrics translation and 2. proactive troubleshooting.

nielsvbrecht/meteocontrol-mcp · 508 tokens

visual-explainer-extension GEMINI.md

Instructions for Jakedismo/visual-explainer-extension, covering visual-explainer, project overview, main technologies, extension structure and available commands.

Jakedismo/visual-explainer-extension · 806 tokens

gemini-mem GEMINI.md

Instructions for djinn-soul/gemini-mem, covering gemini.md, memory behavior and operator notes.

djinn-soul/gemini-mem · 99 tokens

victoriametrics-logs-mcp GEMINI.md

Gemini CLI instructions for nielsvbrecht/victoriametrics-logs-mcp, covering core capabilities, victoriametrics (metrics), victorialogs (logs), available tools and metrics tools.

nielsvbrecht/victoriametrics-logs-mcp · 512 tokens

gemini-api-docs-mcp-ext GEMINI.md

Gemini CLI instructions for derailed-dash/gemini-api-docs-mcp-ext, covering gemini api documentation agent instructions, capabilities, when to use, best practices and official reference.

derailed-dash/gemini-api-docs-mcp-ext · 237 tokens