Agent-os-open: Instructions file for Codex

AGENTS.md

Agent-os-open AGENTS.md is an instructions file for Codex, OpenCode from jianchen08/Agent-os-open. It costs 3,156 tokens per session, scanned A, original, Apache-2.0.

Repository instructions for AI coding agents working on the AgentOS project. They describe the project's Rust, Python, and React parts, its folder layout, and rules for making changes.

In plain words
What is it for?
Use them when working in the AgentOS repository to understand its architecture, storage, tests, documentation, and commit requirements.
Why use it?
They give an agent the project context and local working rules before it edits code. This reduces the chance of changing the wrong area or losing uncommitted work.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md.

This is jianchen08/Agent-os-open's own configuration. It tells Codex and OpenCode how to work on Agent-os-open 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 Agent-os-open configures →

Reuse

Borrowing it

Nothing to install: this file belongs to jianchen08/Agent-os-open. 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/jianchen08/Agent-os-open/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/jianchen08/Agent-os-open

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 Agent-os-open AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/jianchen08/agent-os-open/agents-md.svg)](https://agentmods.dev/instructions/jianchen08/agent-os-open/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/jianchen08/agent-os-open/agents-md"><img src="https://agentmods.dev/badge/instructions/jianchen08/agent-os-open/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,156 This file is loaded in full into every session.
When invoked 3,156 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.1 $0.03156 $0.03156
Opus 5 $0.01578 $0.01578
Sonnet 5 $0.00631 $0.00631
Haiku 4.5 $0.00316 $0.00316

Measured yesterday against content hash 3ed0443f8bee, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

Agent-os-open 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 yesterday.

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 · 141 lines

How it starts

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

灵汐 AgentOS — 项目记忆(供 AI 协作者)

本文件是给在本仓库工作的 AI 代理(DSH 等)的项目上下文。读完它再动手; 口径冲突时以本文件 + docs/decisions/ 为准(README / ARCHITECTURE / guides 已对齐 0.2 现状)。

项目是什么

可进化的智能体操作系统:把 LLM、工具、记忆、任务、配置组织成可观测、可干预、 可回滚的管道(Pipeline)。当前主线为 0.2 架构:Rust 微内核 + Python 插件 + React 前端。

仓库布局(0.2 现实)

路径 内容
kernel/ Rust 微内核(crates:api/config/core/db-admin/engine/hooks/http/invoker/mcp/plugin-loader/session/tenant/user-admin;agentos-kernel 是主进程)
plugins/ Python 插件(shared/system/ 系统插件、shared/tools/ 工具插件、shared/pipeline/ 管道插件)
frontend/src/ React 19 + Vite + Zustand + Antd(RJSF v6 表单引擎)
config/ 运行配置(agents/tools/plugins/pipelines/isolation/storage.yaml 等)
docs/ 文档;docs/decisions/ = ADR 决策记录;docs/working/ = 工作文档与研究报告
tests/ Python 测试(pytest);kernel/crates/*/tests/ Rust 测试
scripts/ 运维/清理脚本
data/logs/reports/ 运行时产物

存储:SQLite(默认项目根 agentos_kernel.db),driver 化切换见 config/storage.yamlAGENTOS_STORAGE_DRIVER/AGENTOS_DB_PATH 环境变量可覆盖)。

⚠️ 工作区铁律(最重要)

受管开发环境(本仓容器工作区)会被周期性还原到 git HEAD——未提交的改动会被抹掉 (普通 clone 无此行为,但提交纪律通用)。任何修改(含中间产物、测试数据)完成后立即 commit,不要留到"最后一起提交"。commit 前的调查/验证工作尽量用未跟踪文件(?? 状态)或文档目录进行。

架构要点(2026-08 现状)

  • 一切皆插件(架构公理,写文档/方案一律以此为基):内核只是执行基座(管道解释 执行/能力注册表/插件装载/存储),一切能力——LLM、记忆、评估、审批、触发器、通道、 主题、乃至 agent 配置的加载——皆插件承载;改业务行为 = 加/改插件或配置,不动内核。 动因六条(自进化落地/改动半径分离/故障隔离/语言生态自由/统一契约/治理单点)与 能力→插件对照表见 docs/ARCHITECTURE.md 设计哲学 §1。
  • 插件即声明:插件 = plugin.json 清单 + Python 实现。capabilities.tools = LLM 工具声明即注册(无需类型豁免);capabilities.services = 内部服务方法元数据。 工具声明要带 output_schema + render(工具契约,tool_core 校验 fail-closed, 前端按 render 意图路由)。插件放 plugins/shared/{system,tools,pipeline}/<name>/
  • 评估闸门:插件判定,内核只落库:判定逻辑已从内核移出归插件——评估裁决 在 plugins/shared/system/evaluation/(task_evaluate 工具),放行检测在管道 output 步骤 task_reminder(提醒耗尽仍无评估证据 → task.status = pending_evaluation,不落 completed;有证据内核才补落默认 completed);内核不 做判定,只经 pipeline-state 写面记录结果。agent 配置加载同样已移出内核,由 管道输入插件 context_build 自持(plugins/shared/pipeline/input/context_build/)。
  • 任务默认隔离执行:默认工作空间 workspace/{task_id} + isolated。
  • 工具面过滤:LLM 可见工具由 config/agents/main/agentos.yaml(及 executor/general_agent.yaml)的 tool_ids 白名单控制,新工具记得加入。
  • 权限模式:5 种权限模式 + 参数级危险判定,纯插件前端(http_endpoints + form compact + human-interaction 确认)。会话隔离由 isolation_guard 容器落地。
  • 插件热发现/热重载全链路:新建插件目录、修改 plugin.json、改插件 Python 代码 均由 watcher 自动处理(发现→G2 校验→注册/重注册/respawn),无需 re-enable 或重启; cdylib 集合变更走 G8 自动重启(同 id 换产物保守重启);已知插件面取自共享 manifests 活集合(新插件热注册后管道引用即可编译);前端 schema 需刷新页面才更新。
  • 多循环体/执行上下文execution_context 贯穿任务链;agent_id 的本质是执行上下文 键——内核无 Agent 运行时对象,语义由插件按键展开(context_build 按键加载配置, 工具面 tool_ids 同属这份执行上下文,与提示词同源注入);内核零 agent 配置 知识(不读 config/agents/**)——工具面过滤 = tool_schema 插件读 state.tool_ids 经内核 tool-surface capability 服务完成(ADR 2026-09-02)。

Read the full file on GitHub · 141 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. yesterday First seen · 141 lines · 3,156 tokens per session scan A 3ed0443f8bee

Subscribe to this mod's changes

Agent-os-open AGENTS.md is an instructions file published in the GitHub repository jianchen08/Agent-os-open (5 stars, last pushed 2d ago), licensed Apache-2.0. It adds 3,156 tokens to every session, about $0.0158 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-09-05.

Related

Other instructions, from other repositories

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,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 tokens

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 · 6,785 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, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 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,469 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens