Veo: Instructions file for Codex

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.