Agent Smith

@jpoindexter

About Agent Smith

Auto-generate AGENTS.md from your codebase

#agents-md #code-context #ai-coding #cursor #claude #copilot #mcp #cli #typescript #codebase-analysis

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "agentsmith": {
      "command": "npx",
      "args": [
        "-y",
        "@jpoindexter/agent-smith",
        "--mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Agent Smith?

Agent Smith is a CLI tool that auto-generates an AGENTS.md file from your codebase. AGENTS.md is an open standard for giving AI coding assistants context about a project, adopted by 60,000+ projects and supported by tools like Cursor, GitHub Copilot, Claude Code, VS Code, and Gemini CLI. It's for developers who want a comprehensive, automatically maintained context file that AI tools read without any configuration.

How to use Agent Smith?

Run directly with npx @jpoindexter/agent-smith in your project directory or install globally with npm install -g @jpoindexter/agent-smith. Use agentsmith (default), or specify a directory with agentsmith ./my-project. Additional flags include --dry-run (preview without writing), --output <file> (custom output), --force (overwrite existing), and output mode flags: --compact, --compress, --minimal, --xml, and a file tree visualization.

Key features of Agent Smith

Scans codebase for components, hooks, API routes, and more
Detects frameworks like Next.js, shadcn/ui, and Prisma
Generates AGENTS.md with approximately 11K tokens by default
Multiple output modes: compact, compress, minimal, XML
Integrates automatically with AI coding tools (no config needed)
Supports dry-run preview and custom output file location

Use cases of Agent Smith

Quickly generate AGENTS.md for a new or existing project
Refresh AGENTS.md when code structure changes significantly
Create a minimal-context version for faster AI responses
Preview the generated file before writing it (dry run)
Generate an XML-format context file compatible with Repomix

FAQ from Agent Smith

What does Agent Smith generate?

It generates an AGENTS.md file—an open standard context file that AI coding tools automatically discover and read.

How does Agent Smith integrate with AI tools?

AI tools such as Cursor, GitHub Copilot, Claude Code, and VS Code automatically discover and read AGENTS.md files with no configuration needed.

Can I customize the output?

Yes. You can specify a custom output file (--output), choose a compact, compress, or minimal mode, output in XML format, or include a file tree. Use --dry-run to preview.

Do I need to install anything to run Agent Smith?

No. You can run it directly with npx @jpoindexter/agent-smith. Optionally, you can install it globally with npm install -g @jpoindexter/agent-smith.

What kinds of code structures does Agent Smith detect?

It detects components, component variants, color tokens, custom hooks, API routes, environment variables, the framework (e.g., Next.js App Router), design system patterns, code patterns, test coverage, barrel exports, hub files (most imported), Props types, and Prisma schema models.

Frequently asked questions

What does Agent Smith generate?

It generates an AGENTS.md file—an open standard context file that AI coding tools automatically discover and read.

How does Agent Smith integrate with AI tools?

AI tools such as Cursor, GitHub Copilot, Claude Code, and VS Code automatically discover and read AGENTS.md files with no configuration needed.

Can I customize the output?

Yes. You can specify a custom output file (`--output`), choose a compact, compress, or minimal mode, output in XML format, or include a file tree. Use `--dry-run` to preview.

Do I need to install anything to run Agent Smith?

No. You can run it directly with `npx @jpoindexter/agent-smith`. Optionally, you can install it globally with `npm install -g @jpoindexter/agent-smith`.

What kinds of code structures does Agent Smith detect?

Comments

Basic information

More AI & Agents MCP servers

21st.dev Magic AI Agent

21st-dev

It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic

5.3K

欢迎来到智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797