areco: Instructions file for Codex

AGENTS.md

areco AGENTS.md is an instructions file for Codex, OpenCode from bb4407777/areco. It costs 1,450 tokens per session, scanned A, original, Apache-2.0.

Repository instructions for areco, a multi-agent software project. They describe handoffs, testing, deployment, file organization and rules for keeping desktop and mobile changes aligned.

In plain words
What is it for?
Use them when changing areco to run its tests, check both desktop and mobile interfaces, document fixes, inspect real session data, commit work, and record verification and rollback details.
Why use it?
They help coding agents preserve the project’s operating practices and leave a traceable record of changes. This reduces regressions that are hard to attribute or repeat across multiple agents.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: reads .claude/ paths; mentions Claude Code; reads ~/.codex paths.

This is bb4407777/areco's own configuration. It tells Codex and OpenCode how to work on areco itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything areco configures →

Reuse

Borrowing it

Nothing to install: this file belongs to bb4407777/areco. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/bb4407777/areco/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/bb4407777/areco

Made for: Codex, OpenCode.

Wrote 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.

agentmods badge for areco AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/bb4407777/areco/agents-md/github.svg)](https://agentmods.dev/instructions/bb4407777/areco/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/bb4407777/areco/agents-md"><img src="https://agentmods.dev/badge/instructions/bb4407777/areco/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.

agentmods 80×15 button for areco AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/bb4407777/areco/agents-md"><img src="https://agentmods.dev/badge/instructions/bb4407777/areco/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,450 This file is loaded in full into every session.
When invoked 1,450 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.01450 $0.01450
Opus 5.5 $0.00580 $0.00580
Sonnet 5.5 $0.00290 $0.00290
Haiku 4.5 $0.00145 $0.00145

Measured 1mo ago against content hash d6fe357c131d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

areco 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 1mo 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 · 64 lines

How it starts

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

AGENTS.md(areco 仓内 agent 行为约束)

本仓由多 agent(Claude Code / Codex / WorkBuddy / Kimi CLI …)接力开发。 每条规则都踩过坑,别删,只增补。

交接纪律(2026-07-19 定)

  1. 每棒收尾前必须 git commit——工作区不过夜。攒一天 20+ 文件未提交, 出了回归无法归因是谁哪一棒引入的(当日桥水绑定/红绿灯两起回归即教训)。
  2. 行为变更必须拿真实数据自验再交接:跑一遍真实看板/真实 transcript 目录 (~/.claude/projects、~/.codex/sessions、~/.codebuddy/projects), 单测全绿不算完——严格绑定器单测全过、一碰真实软链双候选就拒绑即教训。
  3. 交接文件(data/handoff/)写清:本棒 commit 范围、改了什么行为、 有什么没验证到。
  4. 每个新功能/修复 = 一份独立工程档案(2026-07-27 高律师定):除「交接」用途外, 功能/修复本身要有一份独立档案 data/handoff/YYYY-MM-DD-<主题>.md,写清根因/动机、 改了哪些代码(文件:行)、怎么验证(测试/实测)、回滚方法、部署门槛、未办/风险。 下次同类故障先查档案 + git log,不从零排查——「不知道哪次修改把原有功能改没了」 即靠此追溯。无档案 = 没干完。 示范:data/handoff/2026-07-27-claude-transcript-binding-fix.md。

本仓操作

  • 桌面/手机双端同步上线(2026-07-22 高律师定):任何 UI 功能改动必须先想清 两端的落点——桌面侧栏(SessionSidebar)与手机看板(DashboardView 卡片流)是 两套组件,改一套不等于另一套生效。共用逻辑抽成公共模块(如 utils/sessionGroups), 不许复制两份漂移;交付前两端各过一遍。
  • 测试:npm test(tsx --test,含服务端/客户端/共享层);类型检查即构建前置。
  • 部署:./start.sh restart(launchd com.areco 已接管,脚本自动转发 kickstart); 生产 8790 可能有用户在舱内开着的会话,重启前先 /api/sessions 看一眼。
  • shell 脚本:macOS 系统 bash 3.2 下 $VAR 后紧跟中文/全角字符会把首字节 粘进变量名(set -u 直接炸)——变量后接 CJK 一律写 ${VAR}。
  • config.json、data/、bin/ 是 gitignore 的本机私有物,不入仓。
  • 桌面壳 packages/app/(2026-08-13 新增,独立 package):Electron 壳,只 loadURL 到 areco server(默认 8790,ARECO_URL 覆盖),不打包前端、无 IPC;改 server 端口 或部署形态时同步看它。档案:data/handoff/2026-08-13-areco-desktop-shell.md。

复用模式清单(2026-07-24 高律师定:一套更换,改一处必同步)

这些是仓里已经沉淀的共用模块/版式约定。新功能先查这里有没有现成的, 不许复制第二份;改版式/判断逻辑时按「同步面」整组改,漏一处就是回归。

消息气泡版式(三处同构,改版式必须整组改)

  • 统一结构:.msg-meta(发送者名/模板名,泡泡上方)→ .bubble → .msg-foot (左「📋 复制 / ✓ 已复制」,右完整时间 fmtFullTime)。
  • 落点:ChatMessage.vue(对话模式 + 历史日志页共用组件,模板名走 agentLabel prop) 与 GroupChatView.vue 消息块(项目,self 消息 foot 整体右对齐)。

utils/format.ts(会话展示的判断与格式化,唯一出处)

  • templateLabel / templateColor:模板名与颜色(模板已删有兜底)。
  • chatCapable / sessionEntryPath:会话有无对话视图、按偏好算落点路由—— 看板点卡片、侧栏、新建会话三处共用,禁止在调用处重写判断。
  • fmtFullTime:气泡右下角完整时间,两端统一格式。
  • trafficColor / statusTagText:红绿灯与状态文案。

Read the full file on GitHub · 64 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. 1mo ago Changed · +3 lines · +100 tokens per session d6fe357c131d
  2. 2mo ago First seen · 61 lines · 1,350 tokens per session scan A 7855ab01b6be

Subscribe to this mod's changes

areco AGENTS.md is an instructions file published in the GitHub repository bb4407777/areco (2 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 1,450 tokens to every session, about $0.0058 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-31.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,461 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,750 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens