Add blog post: Design for the Human, Enable the Agent#7598
Add blog post: Design for the Human, Enable the Agent#7598arjunmehta-git wants to merge 3 commits intomasterfrom
Conversation
Signed-off-by: Yi Nuo <218099172+yi-nuo426@users.noreply.github.com>
There was a problem hiding this comment.
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.
src/collections/blog/2026/04-07-design-for-the-human-enable-the-agent/index.mdx
Show resolved
Hide resolved
src/collections/blog/2026/04-07-design-for-the-human-enable-the-agent/index.mdx
Outdated
Show resolved
Hide resolved
| tags: | ||
| - ai | ||
| - mesheryctl | ||
| - Meshery | ||
| - Engineering | ||
| - Platform Engineering |
There was a problem hiding this comment.
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).
src/collections/blog/2026/04-07-design-for-the-human-enable-the-agent/index.mdx
Outdated
Show resolved
Hide resolved
| 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 was a problem hiding this comment.
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.
| 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. |
…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>
|
Excellent piece, @arjunmehta-git. Using A few items before merge:
Strong technical writing here. Wrap up the test plan and this is close. |
Summary
mesheryctl) redesign as a detailed case study, covering design management, model authorship, component definitions, and relationship definitionsTest Plan
gatsby develop<Link>components resolve to valid routesBlockquote,Callout, andCTA_FullWidthcomponents render without errors