Skip to content

docs: recommend CLI mode over MCP for AI coding agents#29

Merged
pszymkowiak merged 1 commit intomainfrom
docs/cli-over-mcp
Mar 16, 2026
Merged

docs: recommend CLI mode over MCP for AI coding agents#29
pszymkowiak merged 1 commit intomainfrom
docs/cli-over-mcp

Conversation

@pszymkowiak
Copy link
Copy Markdown
Contributor

Summary

  • Recommend vox init -m cli over MCP for terminal-based AI agents (Claude Code, Codex)
  • Add CLI vs MCP comparison table with reliability and token cost data
  • Link to MCP vs CLI benchmark study (CLI: 100% reliable, 10-32x cheaper)
  • MCP still recommended for GUI tools (Cursor, VS Code)

Why

AI agents forget to use MCP tools because they're deferred (require schema lookup). CLI tools are in the core Bash toolset — always available, no discovery overhead.

CLI tools are 10-32x cheaper and 100% reliable vs 72% for MCP
(TCP timeouts, JSON schema overhead per call). Add comparison
table and link to benchmark study.

MCP remains recommended for GUI-based tools (Cursor, VS Code).

Signed-off-by: Patrick szymkowiak <patrick.szymkowiak@innovtech.eu>
@pszymkowiak pszymkowiak merged commit 585a9a1 into main Mar 16, 2026
3 checks passed
@pszymkowiak pszymkowiak deleted the docs/cli-over-mcp branch March 16, 2026 07:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant