aws-iot-securetunneling-localproxy is a C++ reference implementation of a local proxy that carries a single-threaded TCP client or server connection through AWS IoT Secure Tunneling. It is used to connect devices or services across a tunnel, with proxy instances running at both ends on Linux, Windows, or macOS. The catalogue instruction supports building, configuring, and running this proxy.
Borrowing it
Nothing to install: this file belongs to aws-samples/aws-iot-securetunneling-localproxy. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/aws-samples/aws-iot-securetunneling-localproxy/main/AGENTS.mdgit clone --depth 1 https://github.com/aws-samples/aws-iot-securetunneling-localproxyWrote 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.
[](https://agentmods.dev/instructions/aws-samples/aws-iot-securetunneling-localproxy/agents-md)<a href="https://agentmods.dev/instructions/aws-samples/aws-iot-securetunneling-localproxy/agents-md"><img src="https://agentmods.dev/badge/instructions/aws-samples/aws-iot-securetunneling-localproxy/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/aws-samples/aws-iot-securetunneling-localproxy/agents-md"><img src="https://agentmods.dev/badge/instructions/aws-samples/aws-iot-securetunneling-localproxy/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.02164 | $0.02164 |
| Opus 5.5 | $0.00866 | $0.00866 |
| Sonnet 5.5 | $0.00433 | $0.00433 |
| Haiku 4.5 | $0.00216 | $0.00216 |
Grade C, and why
aws-iot-securetunneling-localproxy AGENTS.md scanned grade C with 2 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 2mo 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.
Downloads and executes remote codehighSupply chain
curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.
curl -sSf -L https://install.lix.systems/lix | sh -s -- install Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
curl -sSf -L https://install.lix.systems/lix | sh -s -- install How it starts
The opening of the file, as written. The whole thing — 182 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
Guidance for agents (and humans) making commits to
aws-iot-securetunneling-localproxy. This repo is a C++14 / CMake project
(not a Brazil package); it uses Boost.Asio/Beast, protobuf and OpenSSL, and a
Nix flake provides the formatter. See CONTRIBUTING.md for the project's
overall contribution policy (issues, PRs, CLA).
TL;DR commit checklist
Before every commit:
- Make one focused, logical change.
- Update the unit tests and UATs the change affects (see below).
nix fmt— format the tree (must end clean / idempotent).- Run the spelling check (see Spelling); add legitimate technical terms to
misc/dictionary.txtif flagged. - Build and run the unit tests (see below); ensure they pass.
- Stage only the files for this change; write a clear message (see below).
- Never commit to
main; never force-push a shared branch without coordinating.
Branching
- Work on a feature branch named
dev/<short-kebab-name>(e.g.dev/security-audit-findings). - Per
CONTRIBUTING.md, work against the latestmainand keep a change focused on one thing — don't reformat unrelated code. - History may be reworded/rebased only while the branch has not been pushed. Once shared, prefer new commits; rewriting then requires a coordinated force-push.
One change per commit
- Each commit should be a single, self-contained change (one fix / one feature). Don't mix unrelated changes.
- Keep the tests and docs for a change in the same commit as the change (e.g. URL-parsing tests live with the URL-parsing fix).
- With each feature or fix, update the unit tests (
test/, Catch2) and the UATs (uat/) as needed so behavior stays covered: add cases for new behavior and adjust existing ones instead of deleting them. - Keep formatting in the same commit as the code it applies to. Normally
this is automatic: just run
nix fmtbefore committing. (Redistributing formatting across already-made commits is only needed if it was applied after the fact — not part of the normal flow.)
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.
- 2mo ago First seen · 182 lines · 2,164 tokens per session scan C 9060046d459f
aws-iot-securetunneling-localproxy AGENTS.md is an instructions file published in the GitHub repository aws-samples/aws-iot-securetunneling-localproxy (90 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 2,164 tokens to every session, about $0.0087 per session on Opus 5.5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
aws-iot-securetunneling-localproxy AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| aws-iot-securetunneling-localproxy AGENTS.mdaws-samples/aws-iot-securetunneling-localproxy | Instructions file | 90 | 2mo ago | Apache-2.0 | C | 2,164 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | yesterday | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |