Borrowing it
Nothing to install: this file belongs to AgoraIO/cli. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/AgoraIO/cli/main/AGENTS.mdgit clone --depth 1 https://github.com/AgoraIO/cliWrote 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.
[](https://agentmods.dev/instructions/agoraio/cli/agents-md)<a href="https://agentmods.dev/instructions/agoraio/cli/agents-md"><img src="https://agentmods.dev/badge/instructions/agoraio/cli/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/agoraio/cli/agents-md"><img src="https://agentmods.dev/badge/instructions/agoraio/cli/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.03507 | $0.03507 |
| Opus 5.5 | $0.01403 | $0.01403 |
| Sonnet 5.5 | $0.00701 | $0.00701 |
| Haiku 4.5 | $0.00351 | $0.00351 |
Grade A, and why
cli AGENTS.md scanned grade A with 2 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 1mo 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.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
curl -sSfL https://golangci-lint.run/install.sh \ Runs shell commandslowCapability
Expected in a hook, worth knowing in a rule or an instructions file.
2. `bin/agora.js` resolves `agoraio-cli-<platform>/bin/agora` and `spawnSync`s it with all args inherited How it starts
The opening of the file, as written. The whole thing — 277 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Agent and Contributor Guide
Repo Purpose
This repository contains Agora CLI, the native CLI for Agora developer onboarding. It ships as a single binary with no runtime dependencies and is the primary distribution. The same binary is also published via npm as agoraio-cli (a thin shim that runs the native executable).
Quick Reference
| Task | Command |
|---|---|
| Build binary | go build -o agora . |
| Run all tests | go test ./... |
| Inspect full command tree | ./agora --help --all |
| Machine-readable full command tree | ./agora --help --all --json |
| Agent introspection artifact | ./agora introspect --json |
| Machine-readable output | Add --json to any command |
Source Layout
main.go Entry point — wires the root command and calls Execute()
cmd/
gendocs/ Regenerates docs/commands.md from the live cobra tree
internal/cli/
app.go App struct, Execute(), output-mode resolver, env snapshot
commands.go Root command tree; subcommand builders for auth/config/upgrade/etc.
envelope.go JSON envelope shape, exit-code plumbing, error helpers
render.go Pretty output dispatch (renderResult, printBlock, printDoctor)
paths.go Config / session / context paths, writeSecureJSON
config.go appConfig type, defaults, env injection
version.go Build-time version vars, versionInfo, formattedVersion
introspect.go agora introspect + buildIntrospectionData (agent discovery contract)
mcp.go agora mcp serve — JSON-RPC MCP tool dispatch
open_targets.go Canonical URLs for agora open (docs, Console, product docs)
features.go Product feature catalog (rtc/rtm/convoai) shared by doctor, introspect, init defaults
cache.go Short-lived on-disk API caches (project list for shell completion)
completion.go Dynamic shell completion helpers
upgrade.go agora upgrade self-update logic (download, SHA-256, atomic rename)
progress.go NDJSON progress event emitter for long-running JSON-mode commands
auth.go login / logout / whoami / auth status
projects.go project create / use / show / env / env write / doctor
quickstart.go quickstart create / env write / list
recipes.go official recipe API client, discovery, and recipe scaffold setup
init.go init — one-step: project + quickstart/recipe + env
doctor.go project doctor — readiness checks, workspace mode
install_doctor.go Top-level agora doctor — install self-test (PATH, network, auth, MCP host)
env_help.go agora env-help — authoritative env-var catalog
skills.go agora skills — curated workflow recipes (in-binary catalog)
telemetry.go telemetryClient interface + noop sink + Sentry placeholder (wire-up scheduled for next release)
local_project.go .agora/project.json read/write; repo-local project binding
runtime_support.go Template/runtime detection (nextjs, python, go), CI auto-detect, banner rules
app_test.go Unit tests for app init and config
integration_test.go Integration tests: build binary, shell out, assert JSON
docs/
automation.md Stable JSON output contract — machine-consumption source of truth
install.md Direct installer, platform, CI, and security guidance
_config.yml Jekyll / GitHub Pages configuration (human docs site)
_layouts/, assets/ Theme assets for Pages
scripts/
preview-pages-site.sh Local Jekyll build + URL injection (`make docs-preview`)
prepare-pages-site.py Pages artifact prep (Markdown /md mirror, token expansion)
.github/workflows/
ci.yml Push/PR matrix: Ubuntu, macOS, Windows
release.yml Tag-driven cross-platform release
pages.yml Publish docs to GitHub Pages
apt-repo.yml Signed apt repository publishing
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.
- 1mo ago Changed · +3 lines · +60 tokens per session d0a7594bd98e
- 2mo ago First seen · 274 lines · 3,447 tokens per session scan A 68730bfa2265
cli AGENTS.md is an instructions file published in the GitHub repository AgoraIO/cli (5 stars, last pushed 18d ago), licensed MIT. It adds 3,507 tokens to every session, about $0.0140 per session on Opus 5.5. A static security scan graded it A with 2 findings (makes network calls, runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
deepseek-harness AGENTS.md
AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.