AGENTS-example

A project rule requiring every shell command to run through aep-caw, a tool that uses sandboxed sessions.

In plain words
What is it for?
It tells agents how to run commands such as listing files, installing packages, and building the project through aep-caw.
Why use it?
It standardizes command execution and limits where project commands can run.

Agent

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 agents/thepm001/aep-agent-element-protocol/agents-example
Clone the repo
git clone --depth 1 https://github.com/thePM001/AEP-agent-element-protocol
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 462 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 $0.00000 $0.00462
Opus 5 $0.00000 $0.00231
Sonnet 5 $0.00000 $0.00092
Haiku 4.5 $0.00000 $0.00046

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

Security

Grade A, and why

AGENTS-example 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 2d 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.

AEP-Components/caw-framework/examples/agents/AGENTS-example.md · 72 lines

What it actually says

Command Execution via aep-caw

All shell commands in this project MUST be executed through aep-caw.

When using the Bash tool, wrap every command with aep-caw exec:

Required Syntax

aep-caw exec SESSION_ID -- COMMAND [ARGS...]

The -- separator is required between the session ID and the command.

Examples

Instead of:

ls -la
npm install
go build ./...

Use:

aep-caw exec my-session -- ls -la
aep-caw exec my-session -- npm install
aep-caw exec my-session -- go build ./...

When AEP_CAW_SESSION_ID is set, pass all command arguments after exec:

export AEP_CAW_SESSION_ID=my-session
aep-caw exec -- ls -la
aep-caw exec -- npm install

Auto-Creating Sessions

Use --root to auto-create a session if it doesn't exist:

aep-caw exec my-session --root /path/to/workspace -- ls -la

Or set the environment variable:

export AEP_CAW_SESSION_ROOT=/path/to/workspace
aep-caw exec my-session -- ls -la

Common Flags

Flag Description
--timeout 30s Command timeout (e.g., 30s, 5m)
--output json JSON structured output
--stream Stream output as produced
--pty Interactive PTY mode

Environment Variables

Variable Description
AEP_CAW_SESSION_ID Default session ID (avoids passing as argument)
AEP_CAW_SESSION_ROOT Root directory for auto-creating sessions
AEP_CAW_SERVER Server URL (default: http://127.0.0.1:18080)
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. 2d ago First seen · 72 lines · 0 tokens per session scan A 4465209cf3d5

Subscribe to this mod's changes

AGENTS-example is an agent published in the GitHub repository thePM001/AEP-agent-element-protocol (5 stars, last pushed 6d ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 462 tokens. 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-31.

Related

Other agents, from other repositories

api-designer

REST and GraphQL API design - endpoint design, request/response schemas, versioning, and documentation. Use for designing new APIs or evolving existing ones.

AgentWorkforce/relay · 35 tokens

slide-design

You are the deck's art director. The content-planner already did the reading, fact-checked the claims, and settled the narrative — what each slide says is locked and approved. Your job is the other half: decide how the deck looks and moves so that already-correct content lands. You think like an experienced…

addsumtech/slides_maker · 0 tokens

external-system-integration-expert

你负责把当前项目与外部 API、API 网关及业务系统安全地连接起来:识别集成边界、整理接口与环境差异、验证请求和响应、定位认证或数据契约问题。.

agents-universe/agents-universe · 33 tokens

Audit

Deep security + performance audit of a specific diff. Wraps /skill:security-hardening and /skill:performance-optimization (analysis phase only). Use when a change touches auth, untrusted input, secrets, webhooks, PII, or a latency/throughput budget — a focused, read-only risk pass that returns findings the parent…

BlackBeltTechnology/pi-agent-dashboard · 98 tokens

python-pro

Write idiomatic Python code with advanced features like decorators, generators, and async/await. Optimizes performance, implements design patterns, and ensures comprehensive testing. Use PROACTIVELY for Python refactoring, optimization, or complex Python features.

echoVic/blade-code · 51 tokens

security-auditor

Use this agent when reviewing local code changes or pull requests to identify security vulnerabilities and risks. This agent should be invoked proactively after completing security-sensitive changes or before merging any PR.

NeoLabHQ/context-engineering-kit · 40 tokens