caracal command-architecture.instructions.md

caracal command-architecture.instructions.md is an instructions file for GitHub Copilot from Garudex-Labs/caracal. It costs 342 tokens per session, scanned A, original, Apache-2.0.

Rules for keeping Caracal's command-line tools focused on starting, stopping, checking, and cleaning up local services, while product administration stays in the web console. A command-line tool is a text-based way to control software.

In plain words
What is it for?
Use them when changing Caracal commands, package scripts, the web console, command lists, autocomplete, or command documentation.
Why use it?
They prevent runtime commands from being mixed with administrative tasks such as managing zones, policies, credentials, or audit data.

Instructions file for GitHub Copilot

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/garudex-labs/caracal/command-architecture
Clone the repo
git clone --depth 1 https://github.com/Garudex-Labs/caracal

Made for: GitHub Copilot.

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 caracal command-architecture.instructions.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/garudex-labs/caracal/command-architecture.svg)](https://agentmods.dev/instructions/garudex-labs/caracal/command-architecture)
Your own site
<a href="https://agentmods.dev/instructions/garudex-labs/caracal/command-architecture"><img src="https://agentmods.dev/badge/instructions/garudex-labs/caracal/command-architecture.svg" alt="Measured on agentmods" height="20"></a>
Per session 342 This file is loaded in full into every session.
When invoked 342 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.1 $0.00342 $0.00342
Opus 5 $0.00171 $0.00171
Sonnet 5 $0.00068 $0.00068
Haiku 4.5 $0.00034 $0.00034

Measured 5d ago against content hash c141294b5736, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

caracal command-architecture.instructions.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.

.github/instructions/command-architecture.instructions.md · 17 lines

What it actually says

Command Architecture

  • Top-level caracal runtime CLI commands must only manage local runtime lifecycle and setup: start, stop, status, purge, and optional interface launchers such as web.
  • Top-level package scripts must not provide product-management aliases for zones, policies, grants, Control credentials, audit, agents, delegation, or other admin workflows.
  • Product management must live only in the web console and its shared engine/admin helpers, with the Control API or Admin SDK for automation.
  • The web console must expose product capabilities with consistent names, lifecycle behavior, terminology, and engine integration.
  • The web console launcher (caracal web) must remain optional; top-level help and dispatch must hide it when its workspace packages are unavailable.
  • If the web console is unavailable, the top-level runtime CLI must still expose lifecycle commands.
  • Control API management is a web-console product-management surface; it must not be exposed as a top-level runtime command or recursively through remote Control dispatch.
  • Runtime lifecycle code must not require admin tokens, zone selection, product credentials, or Control credentials.
  • Command documentation must show runtime lifecycle examples through caracal and product-management workflows through the web console (caracal web), the Control API, or the Admin SDK.
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 · 17 lines · 342 tokens per session scan A c141294b5736

Subscribe to this mod's changes

caracal command-architecture.instructions.md is an instructions file published in the GitHub repository Garudex-Labs/caracal (205 stars, last pushed 5d ago), licensed Apache-2.0. It adds 342 tokens to every session, about $0.0017 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

emilia-protocol AGENTS.md

AGENTS.md instructions for emiliaprotocol/emilia-protocol, covering repository instructions for ai agents, required first read, source discipline, context maintenance and verification.

emiliaprotocol/emilia-protocol · 697 tokens

Doberman-Core AGENTS.md

AGENTS.md instructions for DobermanCore/Doberman-Core, covering claude.md — doberman operating manual, 0. on startup (every session), 1. what this repository is, 2. architecture & extension points and 3. prime directives (non-negotiable).

DobermanCore/Doberman-Core · 3,652 tokens

emilia-protocol CLAUDE.md

Claude Code instructions for emiliaprotocol/emilia-protocol, covering emilia protocol - repo guide, required context, critical, build & ship and outbound & claims.

emiliaprotocol/emilia-protocol · 852 tokens

emilia-protocol copilot-instructions.md

Copilot instructions for emiliaprotocol/emilia-protocol: Read AGENTS.md and AICONTEXT.md before proposing changes. Current evidence and provenance are in public/.well-known/emilia-context.json. Treat archived, staged, private, and outreach documents as non-authoritative for current behavior or standards status.

emiliaprotocol/emilia-protocol · 63 tokens

emilia-protocol GEMINI.md

Gemini CLI instructions for emiliaprotocol/emilia-protocol: Read AGENTS.md and AICONTEXT.md before analyzing or editing this repository. Use public/.well-known/emilia-context.json for current evidence counts and provenance. Do not infer current behavior or standards status from archived, staged, private, or randomly…

emiliaprotocol/emilia-protocol · 68 tokens

mcp-sso CLAUDE.md

Claude Code instructions for acartag7/mcp-sso, covering claude code session notes (mcp-sso) and repository quality rules.

acartag7/mcp-sso · 420 tokens