VibeRaven AGENTS.md

VibeRaven AGENTS.md is an instructions file for Codex, OpenCode from ohad6k/VibeRaven. It costs 789 tokens per session, scanned A, original, MIT.

Repository instructions for VibeRaven, an open-source tool with a local Studio interface for checking AI-built applications and explaining release changes. They describe the current product and distinguish it from older work.

In plain words
What is it for?
Use them when changing the VibeRaven Studio, its command-line package, provider controls, releases, terminal, diffs, or agent connections.
Why use it?
They prevent developers from working on legacy surfaces or treating an old command and product direction as current.

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/ohad6k/viberaven/agents-md
Clone the repo
git clone --depth 1 https://github.com/ohad6k/VibeRaven

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 VibeRaven AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ohad6k/viberaven/agents-md.svg)](https://agentmods.dev/instructions/ohad6k/viberaven/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/ohad6k/viberaven/agents-md"><img src="https://agentmods.dev/badge/instructions/ohad6k/viberaven/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 789 This file is loaded in full into every session.
When invoked 789 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.00789 $0.00789
Opus 5 $0.00394 $0.00394
Sonnet 5 $0.00158 $0.00158
Haiku 4.5 $0.00079 $0.00079

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

Security

Grade A, and why

VibeRaven 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 5d 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 · 56 lines

How it starts

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

Current VibeRaven Product Focus

This repo is currently focused on the open-source VibeRaven 1.4.3 product:

  • Main command: npx -y viberaven (Studio), or npx -y viberaven check for a terminal verdict
  • Main product surface: the local Studio cockpit UI in packages/cli/src/local-ui/
  • Main workflow: agentic chat, draggable providers, draggable versions/releases, provider MCP context, CLI agent connection, access-mode control, and release diff/change explanation.
  • Main packages for this work: packages/cli, packages/viberaven-shim, and packages/mcp.

The active UI is the Studio cockpit with VibeRaven Chat, Provider Control Board, Versions & Releases, Terminal, Diff, access modes, and CLI agent connection. Do not confuse it with the older localhost launch console.

What Is Legacy / Put Aside

Treat these as legacy or side surfaces unless the user explicitly asks to work on them:

  • The old npx -y viberaven --agent-mode scan/pro-gate loop.
  • Old scan artifacts and old gate/tasklist-first UX.
  • Private VSIX/editor-extension work under src/.
  • Marketplace extension packaging and old private monorepo release surfaces.
  • Marketing/flywheel/automation surfaces unless the task explicitly names them.

Do not base new UI work on old scan pages, old launch-gate cards, old agent-mode command flows, or private extension UI.

Working Rules For This Repo

  • Read the current local UI code before changing behavior: packages/cli/src/local-ui/server.ts, packages/cli/src/local-ui/static/appClient.ts, packages/cli/src/local-ui/static/appCss.ts, and packages/cli/src/local-ui/types.ts.
  • Preserve user/unrelated dirty work. This repo often has many generated files and unrelated edits.
  • Keep changes scoped to the open-source Studio path unless asked otherwise.
  • Do not run or promote npx -y viberaven --agent-mode as the default for this repo's product work.
  • For verification, prefer focused package checks such as:
    • npm --prefix packages/cli run typecheck
    • npm --prefix packages/cli test -- local-ui/server.test.ts
    • npm --prefix packages/cli run build
  • If preparing publish/release, verify the local Studio at http://127.0.0.1:<port>/, /api/project, /api/cli-agents, /api/cli-agents/probe, and /api/agent-chat.

Read the full file on GitHub · 56 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. 5d ago First seen · 56 lines · 789 tokens per session scan A 3dcac6a3e140

Subscribe to this mod's changes

VibeRaven AGENTS.md is an instructions file published in the GitHub repository ohad6k/VibeRaven (35 stars, last pushed 1mo ago), licensed MIT. It adds 789 tokens to every session, about $0.0039 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