Amethyst is an Android client for Nostr, a social network protocol that lets people control their own social activity and connections. People use it to read and publish Nostr content, follow accounts, and exchange encrypted direct messages from Android and other supported platforms. The catalogue add-ons support workflows for developing or operating the client.
Borrowing it
Nothing to install: this file belongs to vitorpamplona/amethyst. 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/vitorpamplona/amethyst/main/AGENTS.mdgit clone --depth 1 https://github.com/vitorpamplona/amethystWrote 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/vitorpamplona/amethyst/agents-md)<a href="https://agentmods.dev/instructions/vitorpamplona/amethyst/agents-md"><img src="https://agentmods.dev/badge/instructions/vitorpamplona/amethyst/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/vitorpamplona/amethyst/agents-md"><img src="https://agentmods.dev/badge/instructions/vitorpamplona/amethyst/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.08582 | $0.08582 |
| Opus 5.5 | $0.03433 | $0.03433 |
| Sonnet 5.5 | $0.01716 | $0.01716 |
| Haiku 4.5 | $0.00858 | $0.00858 |
Grade A, and why
amethyst 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 today.
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.
How it starts
The opening of the file, as written. The whole thing — 546 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Amethyst
Project Overview
Amethyst is a Nostr Client for Android that was made for Android-only and has been slowly switching
over to a Kotlin Multiplatform project. The main modules are: commons, commonsUI, amethyst,
desktopApp, cli, plus the audio-rooms client nestsClient. The protocol code is not in this
repo: Nostr, MLS, the two MLS bindings, QUIC and the crypto primitives are libraries in their own
repos, consumed from Maven Central (see Libraries). Commons stores
shared code between Amethyst Android (amethyst) and Amethyst Desktop (desktopApp). Android now
also ships on laptops, so the direction is one UI: every screen and the navigation shell at every
window size move to commonsUI, amethyst shrinks to an Android shim, and desktopApp is a JVM
shim that renders the same UI (desktopApp/…/desktop/app/, see
commons/plans/2026-09-27-one-ui-android-desktop.md). The legacy desktop app (its own screens,
deck and navigation) is gone: its desktop-only features were rebuilt in the shared UI or dropped
(commons/plans/2026-10-09-legacy-desktop-retirement.md). cli ships amy,
a non-interactive JVM command-line client that drives the same quartz + commons code — used by
humans, agents, and interop tests. geode is a standalone JVM Nostr relay (Ktor) built on quartz's
relay-server code; smaller modules are benchmark (Android macrobenchmarks) and
relayBench (head-to-head relay benchmark — boots geode, strfry and other
relay binaries, replays a shared deterministic corpus, measures ingest/query/
NIP-77 sync; ./relayBench/run.sh, see relayBench/README.md). nestsClient runs
the audio-room protocol on top of quic-kmp for the NIP-53 audio-rooms feature. It implements both IETF draft-ietf-moq-transport-17 (under
moq/) and moq-lite Lite-03 (kixelated's variant, under moq/lite/); the
production listener AND speaker paths both run on moq-lite to interop with the
nostrnests reference relay. The IETF code is kept as a reference + unit-test
implementation for any future IETF target; see
nestsClient/plans/2026-04-26-moq-lite-gap.md.
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.
- today Changed · +4 lines · +91 tokens per session dbc3132294f9
- 6d ago Changed · +3 lines · +98 tokens per session 6e6828d503bf
- 8d ago Changed · +3 lines · +68 tokens per session b5a2be57f91d
- 9d ago Changed · -15 lines · -260 tokens per session 83930affe059
- 12d ago Changed · +1 lines · +22 tokens per session b7c6d9921226
- 13d ago Changed · +3 lines · +77 tokens per session d4969dcc519a
- 14d ago Changed · +10 tokens per session f77d65d25a49
- 15d ago Changed · -10 lines · -109 tokens per session 013be2819166
- 16d ago Changed · -3 lines · -1 tokens per session 27777021ef08
- 18d ago First seen · 560 lines · 8,586 tokens per session scan A afe93a2e747e
amethyst AGENTS.md is an instructions file published in the GitHub repository vitorpamplona/amethyst (1,620 stars, last pushed yesterday), licensed MIT. It adds 8,582 tokens to every session, about $0.0343 per session on Opus 5.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-10-12.
amethyst AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| amethyst AGENTS.mdvitorpamplona/amethyst | Instructions file | 1.6k | yesterday | MIT | A | 8,582 | 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 | today | 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 |