cocode AGENTS.md

Repository instructions that explain the layout and boundaries of the Cocode project, which has separate graphical, terminal, and agent-runtime parts.

In plain words
What is it for?
Use them when navigating Cocode, deciding where a change belongs, or connecting the graphical and terminal clients to the agent runtime.
Why use it?
They help coding agents change the correct part of a multi-project repository and avoid mixing responsibilities between 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/cocode-agency/cocode/agents-md
Clone the repo
git clone --depth 1 https://github.com/cocode-agency/cocode

Made for: Codex, OpenCode.

Per session 1,463 This file is loaded in full into every session.
When invoked 1,463 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.01463 $0.01463
Opus 5 $0.00732 $0.00732
Sonnet 5 $0.00293 $0.00293
Haiku 4.5 $0.00146 $0.00146

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

Security

Grade A, and why

cocode 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 3d 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 · 120 lines

How it starts

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

AGENTS.md

Cocode 产品由三个 同级目录 组成:桌面/Web GUI、终端 TUI、Agent 运行时(harness)。本文件在 git 仓库根目录,覆盖整个工作区;各子目录有独立 pnpm workspace 与依赖。

仓库布局

./
  AGENTS.md           ← 本文件
  cocode-gui/         桌面 / Web GUI(含 .dev/guide、.dev/rfc)
  cocode-tui/         终端 TUI(含 .dev/rfc)
  cocode-harness/     harness 运行时(gitignore,勿提交嵌套副本)

cocode-harness/ 亦可用与其 同级 的独立 clone(例如 ~/www/cocode-harness)。不要在 GUI/TUI 目录中修改 harness 插件或 agent loop。

仓库边界

目录 职责 连 harness 的方式
cocode-gui/ 品牌 UI、设计系统、Host 客户端 HTTP POST + 双 WebSocket → dsh web
cocode-tui/ 终端 UI、JSON-RPC 客户端 stdio NDJSON-RPC → jsonrpc-agent 子进程
cocode-harness/ Cordis 插件树、@deepseek-ai/dsh-* 运行时

跨目录需求:harness 侧实现能力,GUI/TUI 侧消费 wire API。

cocode-gui/

cocode-gui/
  .dev/
    guide/               设计系统(design-system.html 为视觉权威)
    rfc/                 GUI 相关 RFC(pending/、implemented/)
  src/main.ts
  packages/
    connection/          Host 传输(@cocode/gui-connection)
    ui/                  设计令牌与 UI 基元(@cocode/ui)

分层:传输 → app 内 runtime/(会话状态,零 React)→ 呈现(React/Electron + packages/ui)。

.dev/ 下除 guide/rfc/ 外的本地 scratch 不入库;RFC 写在 cocode-gui/.dev/rfc/,不要堆在仓库根。

cd cocode-gui
pnpm install
pnpm run dev          # Electron desktop client (default)
pnpm run dev:web      # browser-only, e.g. design-system.html
pnpm run typecheck

联调:cd ../cocode-harness && pnpm dsh web(默认 http://127.0.0.1:3080)。

Harness 参考:cocode-harness/packages/host/apiproxy/cocode-harness/packages/client/connection/

cocode-tui/

cocode-tui/
  .dev/
    rfc/                 TUI 相关 RFC(pending/、implemented/)
  src/main.ts
  packages/
    connection/          JSON-RPC 传输(@cocode/tui-connection)

TUI 通过 @deepseek-ai/dsh-sdk-client 封装 spawn + session.event 流;技能/slash 走 session.prompt 文本路径。RFC 写在 cocode-tui/.dev/rfc/

cd cocode-tui
pnpm install
pnpm run dev
pnpm run typecheck

Harness 参考:cocode-harness/packages/sdk/client/cocode-harness/examples/jsonrpc-agent/

Read the full file on GitHub · 120 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. 3d ago First seen · 120 lines · 1,463 tokens per session scan A f66af62a639d

Subscribe to this mod's changes

cocode AGENTS.md is an instructions file published in the GitHub repository cocode-agency/cocode (162 stars, last pushed 4d ago), licensed MIT. It adds 1,463 tokens to every session, about $0.0073 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.

Related

Other instructions, from other repositories

dsh-TUI AGENTS.md

AGENTS.md instructions for ccch1mneyyy/dsh-TUI, covering agents.md, 仓库布局, 命令, 上游边界与契约 and 约定与红线.

ccch1mneyyy/dsh-TUI · 2,093 tokens

dsh-worktable AGENTS.md

Instructions for Aisland-SJL/dsh-worktable, covering dsh-worktable 项目规则, 协作方式(用户定案,最高优先级), 边界, 构建与验证 and 领域约定(会话中必须遵守).

Aisland-SJL/dsh-worktable · 4,863 tokens

Xenon CLAUDE.md

Instructions for xianyu-sheng/Xenon, covering claude.md — xenon 项目规范, bug 修复原则, 深度根因分析,而非逐洞补漏, 通用设计,而非特例枚举 and 每次新增 mcp 工具都要加正则 — 不可持续.

xianyu-sheng/Xenon · 1,481 tokens

cetridr AGENTS.md

Instructions for cetridr/cetridr, covering agents.md, project, repo layout (pnpm monorepo), commands and architecture.

cetridr/cetridr · 922 tokens

dsh-TUI CLAUDE.md

Claude Code instructions for ccch1mneyyy/dsh-TUI, a project described as: DSH 官方公众号收录的 TUI 补位插件:Claude Code 风,鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.

ccch1mneyyy/dsh-TUI · 3 tokens

lyshell CLAUDE.md

Claude Code instructions for liangyou09/lyshell, covering claude.md, project, commands, architecture and connection layer.

liangyou09/lyshell · 1,867 tokens