Skip to content

Add blog post: Design for the Human, Enable the Agent#7598

Open
arjunmehta-git wants to merge 3 commits intomasterfrom
blog/design-for-human-enable-agent
Open

Add blog post: Design for the Human, Enable the Agent#7598
arjunmehta-git wants to merge 3 commits intomasterfrom
blog/design-for-human-enable-agent

Conversation

@arjunmehta-git
Copy link
Copy Markdown

Summary

  • Adds a new blog post arguing that CLIs are human interfaces (not APIs) and that the long-standing principle of scriptability is what makes CLIs naturally suited for agentic AI
  • Walks through four concrete requirements agents need from CLIs: runtime schema introspection, hallucination-resistant input validation, NDJSON streaming output, and deterministic exit codes
  • Uses the Meshery CLI (mesheryctl) redesign as a detailed case study, covering design management, model authorship, component definitions, and relationship definitions
  • Discusses the complementary role of MCP (Model Context Protocol) alongside CLIs and introduces six generalizable design principles for agent-native CLI design
  • Includes a professional hero-image SVG with terminal prompt and circuit/node motifs

Test Plan

  • Verify the blog post renders correctly with gatsby develop
  • Confirm hero-image.svg displays properly as thumbnail in blog listing and post header
  • Check all internal <Link> components resolve to valid routes
  • Validate MDX frontmatter fields (date, tags, category, author)
  • Confirm Blockquote, Callout, and CTA_FullWidth components render without errors
  • Test responsive layout on mobile and desktop viewports

Signed-off-by: Yi Nuo <218099172+yi-nuo426@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 8, 2026 14:13
@github-actions github-actions bot added the area/blog New posts or new blog functionality label Apr 8, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a new blog post advocating for “human-first, agent-enabled” CLI design, using Meshery’s mesheryctl redesign as a case study and introducing agent-oriented CLI requirements and principles.

Changes:

  • Adds a new MDX blog post with frontmatter metadata, rich components (Blockquote/Callout/CTA), and CLI examples.
  • Introduces content covering agent needs (schema introspection, validation, NDJSON, exit codes) plus an MCP vs CLI discussion.
  • Includes a hero thumbnail reference (hero-image.svg) for the post.

Comment on lines +11 to +16
tags:
- ai
- mesheryctl
- Meshery
- Engineering
- Platform Engineering
Copy link

Copilot AI Apr 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tag casing/style is inconsistent (mix of lowercase and Title Case). If tags are used for filtering/grouping, this can fragment taxonomy (e.g., Meshery vs meshery). Recommend normalizing tags to the site’s convention (commonly lowercase and, if needed, hyphenated).

Copilot generated this review using guidance from repository custom instructions.
Comment on lines +136 to +140
There's a lively debate in the industry right now about whether the Model Context Protocol (MCP) is the right abstraction for AI-agent-to-tool integration. MCP adoption has exploded - the number of MCP servers tripled to over 1,400 between August 2025 and February 2026. OpenAI adopted it. Google DeepMind endorsed it. The momentum is real.

But MCP is not a replacement for a well-designed CLI. It's a complementary layer. MCP excels at governance - OAuth-based authentication, per-user permissions, structured audit trails, multi-agent orchestration across enterprise boundaries. These are real requirements that CLIs don't natively solve.

Where MCP stumbles is efficiency. Benchmarks show CLI-based agent interactions achieving 28% higher task completion rates with equivalent token budgets. MCP tool descriptions can consume tens of thousands of tokens - GitHub's MCP server exposes over 40,000 tokens of tool definitions. That's context window space the agent can't use for reasoning. CLI interactions are leaner: the agent calls a command, reads stdout, moves on.
Copy link

Copilot AI Apr 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These specific quantitative claims (server counts, benchmark deltas, token counts) are presented without citations/links. Adding references (even inline links) would make the post more verifiable and durable, especially as these numbers can change quickly.

Suggested change
There's a lively debate in the industry right now about whether the Model Context Protocol (MCP) is the right abstraction for AI-agent-to-tool integration. MCP adoption has exploded - the number of MCP servers tripled to over 1,400 between August 2025 and February 2026. OpenAI adopted it. Google DeepMind endorsed it. The momentum is real.
But MCP is not a replacement for a well-designed CLI. It's a complementary layer. MCP excels at governance - OAuth-based authentication, per-user permissions, structured audit trails, multi-agent orchestration across enterprise boundaries. These are real requirements that CLIs don't natively solve.
Where MCP stumbles is efficiency. Benchmarks show CLI-based agent interactions achieving 28% higher task completion rates with equivalent token budgets. MCP tool descriptions can consume tens of thousands of tokens - GitHub's MCP server exposes over 40,000 tokens of tool definitions. That's context window space the agent can't use for reasoning. CLI interactions are leaner: the agent calls a command, reads stdout, moves on.
There's a lively debate in the industry right now about whether the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) is the right abstraction for AI-agent-to-tool integration. Adoption has accelerated as model providers, framework authors, and tool builders have started publishing MCP-compatible SDKs, servers, and guidance, including work from [OpenAI](https://platform.openai.com/docs) and [Google DeepMind](https://deepmind.google/).
But MCP is not a replacement for a well-designed CLI. It's a complementary layer. MCP excels at governance - OAuth-based authentication, per-user permissions, structured audit trails, multi-agent orchestration across enterprise boundaries. These are real requirements that CLIs don't natively solve.
Where MCP can stumble is efficiency. In practice, MCP integrations may add prompt overhead because agents often need tool descriptions and schemas in context; large public server implementations such as [GitHub's MCP server](https://github.com/github/github-mcp-server) illustrate how quickly that metadata can grow. That's context window space the agent can't use for reasoning. CLI interactions are often leaner: the agent calls a command, reads stdout, and moves on.

Copilot uses AI. Check for mistakes.
leecalcote and others added 2 commits April 8, 2026 13:21
…e-agent/index.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Lee Calcote <leecalcote@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Lee Calcote <leecalcote@gmail.com>
@arjunmehta-git
Copy link
Copy Markdown
Author

Excellent piece, @arjunmehta-git. Using mesheryctl as the case study anchors the abstract design principles in something concrete our readers can actually examine — that's exactly the right approach for this audience of platform engineers and SREs.

A few items before merge:

  • Test plan checkboxes — Please run through your own checklist: verify the post renders with gatsby develop, confirm the hero SVG thumbnail appears in the blog listing, and validate that all <Link> components resolve to real routes.
  • mesheryctl references — Double-check that any mesheryctl command examples shown in the post are accurate against the current CLI. Outdated command syntax in a post about CLI design would undermine the message.
  • Internal links — Posts in this category benefit from links back to the Meshery docs and to related Layer5 blog content. A review pass to add 2–3 cross-links would improve SEO and reader flow.
  • Peer review — No community review yet. Please add this to the website meeting agenda for a second set of eyes before merge.

Strong technical writing here. Wrap up the test plan and this is close.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/blog New posts or new blog functionality

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants