Veo AGENTS.md

A repository-specific instruction guide for Veo, a local macOS workspace for the Codex command-line tool. It records product boundaries, architecture rules, and development safeguards.

In plain words
What is it for?
Use it when working in the Veo repository. It guides code, documentation, automation, product copy, repository isolation, local runtime behaviour, and macOS app workflows.
Why use it?
It helps an agent make changes that fit Veo's intended design and local-only operation. It prevents reintroducing features from an older product architecture, such as mobile or hosted components.

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/itsasheruwu/veo/agents-md
Clone the repo
git clone --depth 1 https://github.com/itsasheruwu/Veo

Made for: Codex, OpenCode.

Per session 3,882 This file is loaded in full into every session.
When invoked 3,882 The same file — it is already loaded in full.
Security scan B 1 finding. 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.03882 $0.03882
Opus 5 $0.01941 $0.01941
Sonnet 5 $0.00776 $0.00776
Haiku 4.5 $0.00388 $0.00388

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

Security

Grade B, and why

Veo AGENTS.md scanned grade B with 1 finding 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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- Mechanics: gpt-5.6-sol is only reachable through the Codex CLI — `codex exec` / `codex review` (my `~/.codex/config.toml` defaults to gpt-5.6-sol). Use the codex-implementation, codex-review, and codex-computer-use ski
AGENTS.md · 168 lines

How it starts

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

AGENTS.md — Veo Repository Guide

Veo is a local-first native macOS workspace for the Codex CLI. The repository contains one Mac app, one direct local app-server transport, and no hosted product or mobile companion.

Do not add a mobile companion, relay, phone pairing, subscriptions, hosted deployment, or compatibility layers for an earlier product architecture. Keep code, documentation, automation, assets, and product copy specific to Veo.

Core guardrails

  • Prefer the native Mac app, direct local codex app-server transport, local project folders, and normal macOS window/menu workflows.
  • Be an intraprendente agent: proactively inspect local code, protocol/schema, and official sources to confirm facts before replying; do not repeatedly stop to ask for confirmation when the next verification step is safe and obvious.
  • Keep repo isolation by thread/project metadata and local cwd.
  • Do not reintroduce filtering by selected repo in sidebar/content.
  • Keep cross-repo open/create flow with automatic local context switch.
  • Preserve single responsibility: shared logic belongs in services/coordinators, not duplicated in views.
  • Treat this repo as open source: avoid junk code, placeholder hacks, noisy one-off workarounds, and low-signal docs.
  • Keep public documentation centered on Veo's current Mac app, actual source layout, direct local transport, and explicit access model.
  • Do not create one-off report markdown files in the repo root (security reports, audit notes, scratch summaries, etc.) unless the user explicitly asks for a file. Keep ad-hoc analysis in the chat.
  • Keep user-facing answers compact by default unless the user explicitly asks for more detail.

macOS runtime + timeline guardrails

  • turn/started may not include a usable turnId: keep the per-thread running fallback.
  • If Stop is tapped and activeTurnIdByThread is missing, resolve via thread/read before interrupting.
  • On process reconnect or app relaunch, rehydrate the selected thread and active turn state so Stop remains visible.
  • Treat codex app-server stdout as newline-delimited JSON-RPC only; keep diagnostics on stderr and never mix them into protocol parsing.
  • Keep assistant rows item-scoped to avoid timeline flattening/reordering.
  • Merge late reasoning deltas into existing rows; do not spawn fake extra "Thinking..." rows.
  • Ignore late turn-less activity events when the turn is already inactive.
  • Preserve item-aware history reconciliation instead of falling back to turnId-only matching.

Read the full file on GitHub · 168 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 · 168 lines · 3,882 tokens per session scan B f516ba462320

Subscribe to this mod's changes

Veo AGENTS.md is an instructions file published in the GitHub repository itsasheruwu/Veo (1 stars, last pushed 13d ago), licensed Apache-2.0. It adds 3,882 tokens to every session, about $0.0194 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.