Borrowing it
Nothing to install: this file belongs to hypercycle-development/mosaic-companion. 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/hypercycle-development/mosaic-companion/main/AGENTS.mdgit clone --depth 1 https://github.com/hypercycle-development/mosaic-companionWrote 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/hypercycle-development/mosaic-companion/agents-md)<a href="https://agentmods.dev/instructions/hypercycle-development/mosaic-companion/agents-md"><img src="https://agentmods.dev/badge/instructions/hypercycle-development/mosaic-companion/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/hypercycle-development/mosaic-companion/agents-md"><img src="https://agentmods.dev/badge/instructions/hypercycle-development/mosaic-companion/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.02534 | $0.02534 |
| Opus 5.5 | $0.01014 | $0.01014 |
| Sonnet 5.5 | $0.00507 | $0.00507 |
| Haiku 4.5 | $0.00253 | $0.00253 |
Grade A, and why
mosaic-companion 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 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.
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 — 212 lines — stays where its author put it; the contents beside it link to each section on GitHub.
MosAIc Companion — AI Agent Instructions
This file provides context for AI coding assistants working on this project. Read this before making changes to the codebase.
Project Overview
MosAIc is an Electron desktop app (React + TypeScript) that serves as an AI companion with tool use, wallet integration, and secure sandboxed tool execution.
Stack: Electron (main process) + React (renderer) + TypeScript. Vite for bundling.
Architecture — MUST READ Before Modifying
The project follows a Core (trusted) vs Sandbox (untrusted) architecture for tool execution.
Full architecture docs: /docs/architecture/
Key Rules
- WASM is the primary runtime for sandboxed tools. Docker is optional for heavy workloads (GPU, databases). WASM tools have zero network/filesystem/OS access by default — all capabilities come through host functions.
- The Gatekeeper is host functions, not a container. For WASM tools, the Gatekeeper logic runs directly inside Electron as host functions gated by
GatekeeperPolicy. No separate proxy or container. - Tools are always low-trust. Even tools written by us get the same restrictions in the Sandbox. Trust is architectural, not reputational.
- Every boundary crossing must be: explicit, Core-mediated, and logged.
- No runtime permission escalation — tools declare permissions in their manifest upfront.
GatekeeperPolicyis the base interface for filtering decisions. WASM host functions call it directly now; a future Docker proxy would call the same policy. Same rules, different plumbing.
Key Architecture Docs
| Doc | When to read |
|---|---|
overview.md |
Before modifying any Core or Sandbox code |
manifest.md |
Before changing tool manifests, permissions, or UI panels |
gatekeeper.md |
Before touching outbound network filtering |
container-communication.md |
Before changing how MosAIc talks to tools |
permissions.md |
Before changing the permission model |
data-model.md |
Before modifying Chronicle, Vault, or data flow |
tool-lifecycle.md |
Before changing tool install, launch, or execution flow |
tool-ui.md |
Before changing how tools render UI blocks |
execution-plan.md |
For the Phase 1 implementation sequence |
implementation-status.md |
To check what's built vs planned |
glossary.md |
For term definitions |
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 · 212 lines · 2,534 tokens per session scan A 65b7e8c9793d
mosaic-companion AGENTS.md is an instructions file published in the GitHub repository hypercycle-development/mosaic-companion (20 stars, last pushed 10d ago), licensed Apache-2.0. It adds 2,534 tokens to every session, about $0.0101 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-08-30.
mosaic-companion AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| mosaic-companion AGENTS.mdhypercycle-development/mosaic-companion | Instructions file | 20 | 10d ago | Apache-2.0 | A | 2,534 | 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 |