DSH-better-sidebar AGENTS.md

DSH-better-sidebar AGENTS.md is an instructions file for Codex, OpenCode from omdsh-dev/DSH-better-sidebar. It costs 3,543 tokens per session, scanned A, original, MIT.

A repository rulebook for a Better Sidebar plugin that extends DSH, a host application with a sidebar and plugin system.

In plain words
What is it for?
Use it when building, packaging, testing, mounting, or publishing the plugin, especially when checking compatibility with DSH's alpha release channel.
Why use it?
It prevents changes that would modify the host application directly or violate the checks required for safe plugin packaging and real mounting.

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/omdsh-dev/dsh-better-sidebar/agents-md
Clone the repo
git clone --depth 1 https://github.com/omdsh-dev/DSH-better-sidebar

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 DSH-better-sidebar AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/omdsh-dev/dsh-better-sidebar/agents-md.svg)](https://agentmods.dev/instructions/omdsh-dev/dsh-better-sidebar/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/omdsh-dev/dsh-better-sidebar/agents-md"><img src="https://agentmods.dev/badge/instructions/omdsh-dev/dsh-better-sidebar/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,543 This file is loaded in full into every session.
When invoked 3,543 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.03543 $0.03543
Opus 5 $0.01772 $0.01772
Sonnet 5 $0.00709 $0.00709
Haiku 4.5 $0.00354 $0.00354

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

Security

Grade A, and why

DSH-better-sidebar 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 today.

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

How it starts

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

dsh-better-sidebar 仓库规则(AGENTS)

本文只含项目全局开发规则(面向贡献者与 agent)。 消费插件接入 API 全参考(ctx.betterSidebar 服务、TabDescriptor / FileViewerDescriptor 全字段、声明式设置、自由窗口、皮肤契约等)→ docs/external-plugin-guide.md;逐特性设计史(含实施偏差记录)→ docs/plans/


1. 仓库硬约束(必须遵守)

  • 禁止修改 DSH 源码:对官方 checkout(~/.dsh/source/current)零写入。
  • 代码改动必须走 PR:非文档改动在 feat/* / fix/* 分支开发,gh pr create 发起,review 合并后进 main;仅纯文档改动(README / AGENTS.md / docs/)允许直推 main。
  • 挂载只走 cordis.patch.yml + profile 机制~/.dsh/profiles/<profile>/),插件作为独立包被 profile 引用,不反向侵入 DSH。
  • 市场受管安装约束dependencies / peerDependencies / optionalDependencies 一律不得出现 cordis(按名硬拒,optional 无效),scripts 不得含 preinstall / install / postinstall / prepare。由 tests/market-manifest.spec.ts 守护。
  • 缺能力时用 DSH 现成只读/公开 API 或插件自有路由(如 jobs.output 事件回放:读会话事件日志而非动注册表);做不到先向用户说明取舍,不改 DSH。

2. CI 挂载冒烟(plugin-mount job / pnpm test:mount

「npm 打包 → 真实挂载 → 无头渲染」门禁(证明打包产物在真实 DSH 挂载后不 crash):pnpm build && pnpm pack 产 tarball → scripts/e2e-mount.sh 装进全新 scratch profile(dsh plugin --profile web add file:<tarball>)并启动真实 dsh web(keyless,--port 0)→ tests/e2e/mount.e2e.ts(Playwright)断言 [data-dsh-better-sidebar] 挂载、无错误条/pageerror/console 错误,经「+ 菜单」逐个打开内置 tab(含终端懒加载 chunk),再经文件树打开 seed 文件强制加载 editor chunk(client-editor.js)。

本地:pnpm build && pnpm pack && pnpm exec playwright install chromium && pnpm test:mount。CI 钉 @deepseek-ai/[email protected]next dist-tag;peer 下限 ^0.1.2-rc.1)。e2e spec 命名 *.e2e.ts + vitest exclude 双保险;exclude 必须保留默认排除项(exclude 整体替换默认值)。


3. DSH 0.1.2 适配要点(0.1.2-rc.1+ 基线)

v0.18.0 起插件毕业正式版(npm latest),仅支持 DSH 0.1.2-rc.1+(peer 下限 ^0.1.2-rc.1,CI 钉 @deepseek-ai/[email protected],DSH rc.x 发在 next dist-tag)。v0.18.0-alpha.0 进入 alpha 通道时已删除对 0.1.0-rc.8 ~ 0.1.1-rc.2 的兼容层——双方言 RPC(点分回退)、MarkdownText 双形状 labels、dsh-client-runtime externals/inject 残留行;stable DSH 用户请固定装 v0.17.1(npm 上的旧 latest,0.1.2-alpha.x 宿主继续用 npm alpha 的 v0.18.0-alpha.0)。发版:release.yml 按版本号是否含 - 自动选 alpha/latest dist-tag。

Read the full file on GitHub · 72 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. today Changed · +1 lines · +393 tokens per session c6637437af48
  2. yesterday Changed · +1 lines · +269 tokens per session 50330c62d711
  3. 4d ago Changed · +6 lines · +534 tokens per session eb736be70d02
  4. 4d ago First seen · 64 lines · 2,347 tokens per session scan A a7346f3cddd3

Subscribe to this mod's changes

DSH-better-sidebar AGENTS.md is an instructions file published in the GitHub repository omdsh-dev/DSH-better-sidebar (3,299 stars, last pushed today), licensed MIT. It adds 3,543 tokens to every session, about $0.0177 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-worktable AGENTS.md

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

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

awesome-deepseek-harness-plugins AGENTS.md

Instructions for imsai-sh/awesome-deepseek-harness-plugins, covering repository instructions, the submission gate is the product, generated files, cross-repo contracts (no ci spans both repositories) and permanent urls.

imsai-sh/awesome-deepseek-harness-plugins · 1,057 tokens

dsh-mcp-panel AGENTS.md

Instructions for PerryLink/dsh-mcp-panel, covering agents.md, layout, hard rules applied here, config and build.

PerryLink/dsh-mcp-panel · 1,748 tokens

dsh-enhanced-plugins AGENTS.md

Instructions for sky-unicorn/dsh-enhanced-plugins, covering agents.md — deepseek harness 插件项目通用规则, 权威来源与开始工作前的检查, 插件架构与职责边界, cordis 插件与生命周期 and 配置与 settings.

sky-unicorn/dsh-enhanced-plugins · 3,872 tokens

dsh-progressive-tools AGENTS.md

Instructions for everclear077/dsh-progressive-tools, covering agent instructions, project overview, layout, commands and invariants that must not break.

everclear077/dsh-progressive-tools · 794 tokens

dsh-progressive-tools CLAUDE.md

Instructions for everclear077/dsh-progressive-tools: Follow the repository agent instructions in AGENTS.md. That file is the single source of truth for project overview, commands, invariants, conventions, and the content policy. Do not duplicate guidance here; update AGENTS.md instead.

everclear077/dsh-progressive-tools · 60 tokens