szymdzum

MCP vs CLI: Which Interface Do AI Agents Actually Prefer?

A Benchmark-Driven Comparison of Browser Automation Paradigms

---

Introduction

When building tools for AI agents, developers face a fundamental interface choice: expose functionality through the Model Context Protocol (MCP), or provide a traditional command-line interface (CLI) that agents invoke via shell commands.

szymdzum

Self-Documenting Systems for Autonomous Agents

How tools can teach agents to use them without external documentation

Table of Contents

• The Problem: Documentation Debt
• Core Principle: Tools as Teachers
• Three Pillars of Self-Documentation
• The Discovery Hierarchy

szymdzum

import type { GetStaticPaths } from "astro";
import { siteConfig } from "@/site-config";
import { llmsPost } from "@utils/llms";
import { formatUrl } from "@utils/path";
import { type BlogPost, getAllPosts } from "@utils/posts";

export const getStaticPaths: GetStaticPaths = async () => {
  const posts = await getAllPosts();
  return posts.map((post) => ({
    params: { slug: post.slug },

szymdzum

name	description
Pipeline Investigation	Debug GitLab CI/CD pipeline failures using glab CLI. Investigate failed jobs, analyze error logs, trace child pipelines, and compare Node version differences. Use for pipeline failures, job errors, build issues, or when the user mentions GitLab pipelines, CI/CD problems, specific pipeline IDs, failed builds, or job logs.

Investigating GitLab Pipelines

Use this skill when investigating GitLab CI/CD pipeline issues.

When to Use

szymdzum

#!/usr/bin/env node

/**
 * Developer Hub MCP Server
 * 
 * THE SCIENCE: Why This Works
 * 
 * 1. SEMANTIC MEMORY ARCHITECTURE
 * Human brains have two memory systems:
 * - Episodic (specific events) 

szymdzum

Claude Code Memory Management & Context Optimization Guide

How Claude Code Memory Works

Claude Code uses a simple but powerful file-based memory system centered around CLAUDE.md files. These are automatically loaded into context when Claude Code starts, providing persistent memory across sessions.

Memory File Hierarchy

~/Developer/

szymdzum

HTML is an Interface, and We've Been Treating It Like a Whiteboard

The Interface We All Agreed to Ignore

Picture this: You're reviewing a pull request and you see this beauty:

interface Product {
  sc_kDDrLX: string;      // ??? maybe a title?
 eYUOdi: any; // your guess is as good as mine