os-clovy AGENTS.md

A set of project instructions for Clovy, a desktop app for recording meetings, transcribing audio, creating structured notes, and chatting with an AI agent about those notes.

In plain words
What is it for?
Use it when working on the Clovy codebase, especially its React interface, Rust desktop shell, backend, documentation, or project planning files.
Why use it?
It tells an agent which project documents and technical areas to understand before changing code, reducing the risk of ignoring repository-specific rules.

Instructions file for CodexOpenCode

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/open-software-network/os-clovy/agents-md
Clone the repo
git clone --depth 1 https://github.com/open-software-network/os-clovy

Made for: Codex, OpenCode.

Per session 4,092 This file is loaded in full into every session.
When invoked 4,092 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.04092 $0.04092
Opus 5 $0.02046 $0.02046
Sonnet 5 $0.00818 $0.00818
Haiku 4.5 $0.00409 $0.00409

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

Security

Grade A, and why

os-clovy 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 2d 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 · 279 lines

How it starts

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

For additional context about technologies to be used, project structure, shell commands, and other important information, read specs/003-conversation-turns/plan.md.

Clovy — Agent Instructions

Project

Clovy is a private-by-architecture Tauri desktop app for meeting notes: it records a meeting or dictation, transcribes the audio, turns the transcript into a structured note, and hosts an AI agent you can chat with over your notes. The frontend is React (src/), the native shell is Rust (src-tauri/), and a confidential Rust backend, Clovy API (clovy-api/), proxies all upstream AI and runs metered billing. Identity and credits come from OS Accounts; the agent harness is a Clovy-owned TypeScript service built on the OpenAI Agents SDK; AI models are served through Clovy's model routing. Clovy API runs inside a TEE (Phala) so prompt data is not readable by its own infra.

Read CONTEXT.md before naming anything, and docs/index.md to find the doc for the area you touch.

OS Platform (shared brain)

Platform-enabled repo — Product june, Team os-core, Issue prefix JUN. The product handle and issue prefix are retained June-era technical identities; the current product name is Clovy (see ADR-0055). Use the os_platform_* MCP tools (https://platform-api.opensoftware.co/mcp); REST fallback https://app.opensoftware.co/api + Authorization: Bearer $OS_PLATFORM_API_KEY. Never print or store credentials.

Before work that will produce a branch (skip for Q&A, typos, exploration, CI):

  1. os_platform_get_product{handle:"june"} — response embeds the Product Memory index; os_platform_get_memory only entries whose description touches your task.
  2. Find-or-create the Issue: os_platform_search_product_issues first; create only if no open Issue matches the outcome. One Issue per independently reviewable outcome; reuse it across sessions.
  3. Set the Issue in_progress (os_platform_set_issue_status with the Product handle, Issue number, and status), branch JUN-<number>-<slug>, and put JUN-<number> in commit subjects and the PR title/body. PR-Links advances in_review/completed automatically where installed; if it doesn't, set them yourself. Leave unfinished work in its true status.

Read the full file on GitHub · 279 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. 2d ago First seen · 279 lines · 4,092 tokens per session scan A 59f69cde7024

Subscribe to this mod's changes

os-clovy AGENTS.md is an instructions file published in the GitHub repository open-software-network/os-clovy (357 stars, last pushed 8d ago), licensed MIT. It adds 4,092 tokens to every session, about $0.0205 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.