cli-operations

cli-operations is a skill for Codex from murray17/rovai-ai. It costs 102 tokens per session (771 once invoked), scanned A, original, MIT.

A guide for coordinating work through the Rovai command-line interface, including messages, group requests, lasting tasks and history lookup. Rovai is a system for communication and task coordination between agents.

In plain words
What is it for?
Use it when deciding whether to send a message, ask several members for results, create a tracked task, read past coordination history, or select the next action after a CLI result.
Why use it?
It helps choose the right kind of coordination record and prevents treating a submitted command as proof that the whole job is finished.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: $skill-name invocation.

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 skills/murray17/rovai-ai/cli-operations
Any agent
npx skills add murray17/rovai-ai --skill cli-operations
Clone the repo
git clone --depth 1 https://github.com/murray17/rovai-ai

Made for: Codex.

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 cli-operations

README.md
[![agentmods](https://agentmods.dev/badge/skills/murray17/rovai-ai/cli-operations.svg)](https://agentmods.dev/skills/murray17/rovai-ai/cli-operations)
Your own site
<a href="https://agentmods.dev/skills/murray17/rovai-ai/cli-operations"><img src="https://agentmods.dev/badge/skills/murray17/rovai-ai/cli-operations.svg" alt="Measured on agentmods" height="20"></a>
Per session 102 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 771 The whole file, excluding the scripts and references it only reads on demand.
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.00102 $0.00771
Opus 5 $0.00051 $0.00385
Sonnet 5 $0.00020 $0.00154
Haiku 4.5 $0.00010 $0.00077

Measured 6d ago against content hash 735ada753ae5, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

cli-operations 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 6d 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.

skills/cli-operations/SKILL.md · 53 lines

What it actually says

Rovai CLI 操作协调

快速路径

如果需求已经明确对应一个普通单一操作,不要继续加载本 Skill 的 references。运行 rovai --help 选择 operation,再运行该 operation 的精确 --help;不要假设 command family 有独立 help entry。

选择操作

先判断用户需要留下什么领域事实:

  • Camp 中可见的答复、状态、问题或一次性协作消息:选择 CampMessage。
  • 当前 Default Lead 要把同一主题并行交给多个成员,并在全部成员 Run 终态后只收到一次统一续跑:选择 Gather。
  • 跨 AgentRun 仍需追踪、可独立交接和验收的责任:选择 Task。
  • 查找 Camp、消息或稳定 ID 对应的历史事实:选择 Camp/History 读取。
  • 跨未来 AgentRun 仍有价值的稳定偏好、约定或经验:转交 Memory 治理判断。

边界不清时,优先选择最小且能完整表达用户意图的领域对象。不要用 Task 代替普通公开消息,也不要用 Memory 代替 Task、项目文档或历史证据。

协调多步流程

  1. 先读取做决定所需的权威状态,再执行 mutation。
  2. 为每一步选择一个具体 operation,并查看它自己的精确 --help
  3. 每次调用只使用该 operation 接受的一种输入来源。
  4. 检查 compact business result;只有已提交的 operation 可以作为后续步骤的事实。
  5. 如果当前责任需要 Camp 中的公开答复,在结束前成功发送 CampMessage。

一次 operation 成功只证明该 Rovai operation 已提交,不证明下游执行完成、整体工作质量、测试、评审 或用户意图已经满足。

按需读取

  • 需要决定公开消息、Agent routing、User attention 或是否无需 Task 时,读取 Send
  • 需要并行征集成员结果并让原 Lead 稍后统一综合时,读取 Gather
  • 需要判断消息是否升级为持久责任,或协调 Task 与消息 linkage 时,读取 Task
  • 需要在当前 Camp、指定 Camp、跨 Camp 历史或稳定 ID exact read 之间选择时,读取 Camp 与 History;该 reference 同时定义裸 rovai camp read 的默认 Timeline 行为、message-anchored 显式模式和 cursor 延续规则。
  • 需求可能属于长期记忆时,读取 Memory 路由,随后使用 $memory-stewardship;此处不替代 Memory 治理。
  • CLI 返回 error.recovery,尤其要求 refresh 或确认结果时,读取 Recovery

多步需求可以读取多份直接相关的 reference;不要为了普通单一 operation 预读全部文件。

Files

What ships with it

8 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 6d ago First seen · 53 lines · 102 tokens per session scan A 735ada753ae5

Subscribe to this mod's changes

cli-operations is a skill published in the GitHub repository murray17/rovai-ai (46 stars, last pushed today), licensed MIT. It adds 102 tokens to every session and 771 once invoked, about $0.0005 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.