Title: The agent-native CLI standard
Open Graph Title: The agent-native CLI standard
X Title: The agent-native CLI standard
Description: CLI tools are how AI agents touch everything else. Compilers, databases, git, the cloud, the shell. An agent asked to ship code, rotate a credential, grep a log, or deploy a…
Open Graph Description: CLI tools are how AI agents touch everything else. Compilers, databases, git, the cloud, the shell. An agent asked to ship code, rotate a credential, grep a log, or deploy a…
X Description: CLI tools are how AI agents touch everything else. Compilers, databases, git, the cloud, the shell. An agent asked to ship code, rotate a credential, grep a log, or deploy a…
Opengraph URL: https://anc.dev/
Domain: anc.dev
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://anc.dev/#organization","name":"anc.dev","url":"https://anc.dev","logo":"https://anc.dev/apple-touch-icon-180.png","sameAs":["https://github.com/brettdavies/agentnative","https://github.com/brettdavies/agentnative-cli","https://github.com/brettdavies/agentnative-site","https://github.com/brettdavies/agentnative-skill"]},{"@type":"TechArticle","headline":"The agent-native CLI standard","description":"CLI tools are how AI agents touch everything else. Compilers, databases, git, the cloud, the shell. An agent asked to ship code, rotate a credential, grep a log, or deploy a…","url":"https://anc.dev/","image":"https://anc.dev/og-image.png","author":{"@type":"Person","name":"Brett Davies","url":"https://github.com/brettdavies","sameAs":["https://x.com/brettdavies"]},"publisher":{"@id":"https://anc.dev/#organization"}},{"@type":"SoftwareApplication","@id":"https://anc.dev/#anc-cli","name":"anc","applicationCategory":"DeveloperApplication","operatingSystem":"macOS, Linux, Windows","description":"Agent-native CLI auditor: scores any CLI against the eight principles.","codeRepository":"https://github.com/brettdavies/agentnative-cli","downloadUrl":["https://github.com/brettdavies/agentnative-cli/releases","https://crates.io/crates/agentnative","https://github.com/brettdavies/homebrew-tap"],"installUrl":"https://anc.dev/install","documentation":"https://docs.rs/agentnative","url":"https://anc.dev/audit","offers":{"@type":"Offer","price":0,"priceCurrency":"USD"},"publisher":{"@id":"https://anc.dev/#organization"}},{"@type":"SoftwareApplication","@id":"https://anc.dev/#mcp-server","name":"anc.dev MCP server","applicationCategory":"WebApplication","description":"Streamable-HTTP MCP server exposing the agent-native CLI standard: scorecards, principles, vendored spec.","url":"https://anc.dev/mcp","documentation":"https://anc.dev/mcp-skill","potentialAction":{"@type":"ConsumeAction","name":"Invoke MCP","target":{"@type":"EntryPoint","urlTemplate":"https://anc.dev/mcp","httpMethod":"POST","contentType":"application/json, text/event-stream","encodingType":"application/json"}},"publisher":{"@id":"https://anc.dev/#organization"}},{"@type":"SoftwareSourceCode","@id":"https://anc.dev/#skill-bundle","name":"agent-native-cli skill bundle","description":"Skill bundle for Claude Code, Codex, Cursor, OpenCode.","codeRepository":"https://github.com/brettdavies/agentnative-skill","programmingLanguage":"Markdown","url":"https://anc.dev/skill","downloadUrl":"https://anc.dev/skill.json","publisher":{"@id":"https://anc.dev/#organization"}}]}
| color-scheme | light dark |
| turnstile-sitekey | 0x4AAAAAADQFMBoVm56-OPuQ |
| og:type | article |
| og:image | https://anc.dev/og-image.png |
| og:image:width | 1200 |
| og:image:height | 630 |
| og:image:alt | agent-native CLI standard — anc.dev — a standard for CLIs that agents can operate |
| og:site_name | anc.dev |
| twitter:card | summary_large_image |
| twitter:image | https://anc.dev/og-image.png |
| twitter:image:alt | agent-native CLI standard — anc.dev — a standard for CLIs that agents can operate |
Links:
| Skip to content | https://anc.dev#main |
| anc.dev The agent-native CLI standard | https://anc.dev/ |
| Leaderboard | https://anc.dev/scorecards |
| Install | https://anc.dev/install |
| Audit your CLI | https://anc.dev/audit |
| Skill | https://anc.dev/skill |
| Methodology | https://anc.dev/methodology |
| Coverage | https://anc.dev/coverage |
| About | https://anc.dev/about |
| Contribute | https://anc.dev/contribute |
| /install | https://anc.dev/install |
| /skill | https://anc.dev/skill |
| https://anc.dev/mcp | https://anc.dev/mcp |
| /mcp-skill | https://anc.dev/mcp-skill |
| Install anc locally | https://anc.dev/install |
| 01 Non-Interactive by Default Every automation path MUST run without human input. A CLI tool that blocks on an interactive prompt is invisible to an agent: the agent hangs, the user sees nothing, and the operation times out silently. | https://anc.dev/p1 |
| 02 Structured, Parseable Output CLI tools MUST separate data from diagnostics and offer machine-readable output formats. Mixing status messages with data forces agents into fragile regex extraction that breaks on any format change. | https://anc.dev/p2 |
| 03 Progressive Help Discovery Help text MUST be layered so agents (and humans) can drill from a short summary to concrete usage examples without reading the entire manual. The critical layer is the one that appears after the flags list, because that is where readers look for invocation patterns. | https://anc.dev/p3 |
| 04 Fail Fast with Actionable Errors CLI tools MUST detect invalid state early, exit with a structured error, and tell the caller three things: what failed, why, and what to do next. An error that says "operation failed" gives an agent nothing to act on. | https://anc.dev/p4 |
| 05 Safe Retries and Explicit Mutation Boundaries Every CLI with write operations MUST support --dry-run so agents can preview a mutation before committing it. Commands MUST make the read-vs-write distinction visible from name and --help alone, and destructive writes MUST require explicit confirmation. An agent that cannot distinguish a safe read from a dangerous write will either avoid the tool or execute mutations blindly. Both are failure modes. | https://anc.dev/p5 |
| 06 Composable and Predictable Command Structure CLI tools MUST integrate cleanly with pipes, scripts, and other tools. That means handling SIGPIPE, detecting TTY for color and formatting decisions, supporting stdin for piped input, and maintaining a consistent, predictable subcommand structure. | https://anc.dev/p6 |
| 07 Bounded, High-Signal Responses CLI tools MUST provide mechanisms to control output volume. Agent context windows are finite and expensive: a tool that dumps tens of thousands of lines of unfiltered output wastes tokens on every request and can exceed smaller context windows entirely, breaking the conversation that invoked it. "High-signal" here means the bytes that survive --quiet are the ones the caller asked for (data and errors), not progress, decoration, or chatter. | https://anc.dev/p7 |
| 08 Discoverable Through Agent Skill Bundles Without a skill bundle, every fresh agent invocation begins the same way: pull --help, infer the idioms, try a command, parse the error, try again. A skill bundle (canonical names AGENTS.md or SKILL.md) collapses that loop: agent-discoverable through filesystem convention rather than through --help, loaded once, recognized thereafter. | https://anc.dev/p8 |
| https://chat.openai.com/?q=Summarize%20the%20agent-native%20CLI%20standard%20from%20https%3A%2F%2Fanc.dev%2Fllms-full.txt%20%E2%80%94%20what%20are%20the%20eight%20principles%20and%20why%20do%20they%20matter%20for%20AI%20agents%20using%20CLI%20tools%3F | |
| https://claude.ai/new?q=Summarize%20the%20agent-native%20CLI%20standard%20from%20https%3A%2F%2Fanc.dev%2Fllms-full.txt%20%E2%80%94%20what%20are%20the%20eight%20principles%20and%20why%20do%20they%20matter%20for%20AI%20agents%20using%20CLI%20tools%3F | |
| https://gemini.google.com/app?q=Summarize%20the%20agent-native%20CLI%20standard%20from%20https%3A%2F%2Fanc.dev%2Fllms-full.txt%20%E2%80%94%20what%20are%20the%20eight%20principles%20and%20why%20do%20they%20matter%20for%20AI%20agents%20using%20CLI%20tools%3F | |
| https://x.com/i/grok?text=Summarize%20the%20agent-native%20CLI%20standard%20from%20https%3A%2F%2Fanc.dev%2Fllms-full.txt%20%E2%80%94%20what%20are%20the%20eight%20principles%20and%20why%20do%20they%20matter%20for%20AI%20agents%20using%20CLI%20tools%3F | |
| https://www.perplexity.ai/?q=Summarize%20the%20agent-native%20CLI%20standard%20from%20https%3A%2F%2Fanc.dev%2Fllms-full.txt%20%E2%80%94%20what%20are%20the%20eight%20principles%20and%20why%20do%20they%20matter%20for%20AI%20agents%20using%20CLI%20tools%3F | |
| spec | https://github.com/brettdavies/agentnative |
| cli | https://github.com/brettdavies/agentnative-cli |
| site | https://github.com/brettdavies/agentnative-site |
| skill | https://github.com/brettdavies/agentnative-skill |
| Changelog | https://anc.dev/changelog |
| Scorecard schema | https://anc.dev/scorecard-schema |
| llms.txt | https://anc.dev/llms.txt |
| llms-full.txt | https://anc.dev/llms-full.txt |
| MCP | https://anc.dev/mcp-skill/ |
| This page as markdown | https://anc.dev/index.md |
Viewport: width=device-width,initial-scale=1