dsh-aoci-keeper
Manifest validKeeps an AOCI cognition index from drifting: each turn the model sees the finding count and the maintenance command, so index debt is paid before the task ends. Its HTTP routes have no DSH access chec
dsh-aoci-keeper
Keeps a repository's AOCI cognition index from silently drifting: while the index is unaligned, the plugin adds one reminder line to the model input at the start of a turn, with the finding count and the command that fixes it.
AOCI 认知索引未对齐(governance_aligned=false)。
- findings: 84(stale 75 / pending 10 / missing 2)
- 本轮改动完成后:先 `aoci_maintain` 领取批次并提交,再 `aoci check` 确认归零
No index file is edited, nothing is auto-committed, and a step never waits on the CLI.
Why this exists
AOCI builds a per-repository cognition index that the model reads to understand the codebase, and the
index is maintained by the model itself (aoci_maintain → aoci_update_entry), not by a background
job. DSH has no configurable stop hook, so in practice the index only gets maintained when someone
remembers to ask. This plugin makes the debt visible at exactly the moment it can still be paid: the
start of the next turn.
It is useful when:
- the repository has an
aoci.txtand the index is expected to stay aligned; - you want drift surfaced without reading
aoci checkoutput yourself; - you run long sessions where files change faster than the index.
It does nothing when aoci is missing, no aoci.txt is found, or the index is already aligned.
Install
dsh plugin add dsh-aoci-keeper # from npm
dsh plugin add MrKleene/dsh-aoci-keeper # from source
Requires DSH 0.2.2-rc.3 or newer and the aoci CLI on the host.
How it works
- At the start of a turn the plugin resolves the repository: the configured
repoRoot, else the nearest ancestor of the session'scwdthat holds anaoci.txt, else the nearest ancestor of the host processcwd. - It refreshes
aoci check --jsonin the background when the cached result is older thanrefreshIntervalMs. A step never waits on the CLI. - If the cached result is not
governance_alignedand has at leastminFindingsfindings, it prepends one user-role notice with the count and the top finding kinds. The notice is scoped to the step, so it is not written to the session log. - Reminders are limited to one per turn and to one per
reminderCooldownMsper repository.
Configuration
| key | default | meaning |
|---|---|---|
enabled | true | Turn the keeper off without uninstalling. |
repoRoot | '' | Absolute repository path. Empty means auto-detect. |
command | 'aoci' | AOCI executable. Use an absolute path when the app is launched without the user's PATH. |
refreshIntervalMs | 30000 | Minimum age of the cached check before a background refresh. |
reminderCooldownMs | 600000 | Minimum gap between two reminders for one repository. |
minFindings | 1 | Skip the reminder below this finding count. |
timeoutMs | 20000 | Kill the check after this long. |
extraArgs | [] | Extra arguments appended to aoci check. |
Override in the profile's cordis.patch.yml; the row replaces the bundle's whole config:
- id: aoci-keeper
config:
command: /Users/me/.local/bin/aoci
repoRoot: /Users/me/projects/example
Failure behavior
The plugin degrades to silence rather than to noise: a missing aoci, a timeout, a non-JSON exit, or
a repository without aoci.txt all mean no notice is added. A blocked index is normal — aoci check
exits 1 by design when governance findings exist, and the JSON is still parsed.
License
MIT
Comments
Loading…
Similar plugins
by JiamingShi-JsPhys
DSH 模型矩阵调度中枢:本地 OpenAI 兼容网关 + 四种调度模式(含白嫖)+ 自动容灾 + SQLite 精确缓存
★ 2
MIT
TypeScript
Nov 6, 2026
dsh plugin --profile web add dsh-token-stewardby Isyyyue
给 DSH 里的 AI 一层自己的判断记忆。判断节点 + 确定性取代(supersede)+ 双时态账本 + 双链,规则与人格分开治理,图谱作可解释性界面。 - Persistent judgment memory & self-evolving personality for AI agents (bi-temporal ledger, deterministic supersession, knowledge graph).
★ 3
↓ 370/wk
MIT
JavaScript
Oct 24, 2026
dsh plugin --profile web add dsh-ai-memoryby nlflora
Recovers a DeepSeek Harness turn that ended with reasoning only, with no text and no tool call, by steering the same turn one more step. Structure-only detection, so it costs no extra model call.
★ 0
MIT
JavaScript
Oct 30, 2026
dsh plugin --profile web add @nlflora/dsh-empty-turn-guardby Andrew111888
A floating credit/quota widget for the DeepSeek Harness Web: shows DeepSeek / OpenCode Go balances and usage, and tracks DSH session token usage and estimated cost by day, month, and model.
★ 6
↓ 371/wk
BSD-3-Clause
JavaScript
Aug 26, 2026
dsh plugin --profile web add dsh-plugin-balanceReads the API balance or subscription quota behind the current DSH route — including OpenDesign (AMR) wallet and Design Plan windows via the control plane — and never guesses a figure: a miss reports
★ 1
MIT
JavaScript
dsh plugin --profile web add @zhujiuyi/dsh-balanceby omdsh-plugins
API spend at a glance for the DeepSeek Harness web GUI: this conversation, this project, and the account balance, beside the mode chip in Chat and Work and in the corner in Code
★ 0
MIT
TypeScript
Sep 3, 2026
dsh plugin --profile web add @omdsh-plugins/omdsh-usage