easy-agent
Fully recreating Claude Code from scratch, so anyone can learn how it works.
Easy Agent is an open-source, terminal-native coding agent built with TypeScript and Node.js that recreates Claude Code's workflow from scratch. It provides a complete agentic system with streaming LLM conversations, local file manipulation, shell execution, permission controls, session management, and MCP protocol support. The project includes sub-agent capabilities, agent teams for multi-agent collaboration, and an extensible architecture with skills, hooks, and plugins. Developers can use it as a learning resource to understand how AI coding agents work, or deploy it as a production-ready terminal assistant with multimodal input and headless operation modes.
Key Features
Use Cases
- 01Learning how AI coding agents work by studying the 37-stage incremental implementation
- 02Running an autonomous terminal coding assistant for software development tasks
- 03Building multi-agent systems using sub-agents and agent teams for complex workflows
- 04Integrating custom tools and workflows through MCP servers, skills, and plugins
- 05Automating code review and analysis tasks in headless or pipe mode
- 06Extending AI agent capabilities with custom hooks, output styles, and slash commands
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
easy-agent — FAQ
What is Easy Agent?+
Easy Agent is a terminal-native AI coding agent built with TypeScript and Node.js that recreates Claude Code's workflow. It provides file manipulation, shell execution, MCP integration, sub-agents, and agent teams in a readable, extensible codebase designed for both learning and production use.
How do I install Easy Agent?+
Install globally with npm using 'npm install -g --ignore-scripts eagent', or run without installing via 'npx --yes eagent@latest'. On macOS and Linux, you can also use the installer script. Node.js 22 or newer is required.
What API keys do I need to use Easy Agent?+
You need credentials for at least one supported model provider: ANTHROPIC_AUTH_TOKEN for Anthropic models, OPENAI_API_KEY for OpenAI-compatible services, or GEMINI_API_KEY for Gemini. You can also configure local models through Ollama or other OpenAI-compatible endpoints.
Which AI clients does Easy Agent work with?+
Easy Agent is a standalone terminal application, not a plugin for other AI clients. It runs independently and can be configured to use Anthropic, OpenAI-compatible, Gemini, or local model providers as its backend.
Is Easy Agent free to use?+
Yes, Easy Agent is open-source and released under the MIT license. However, you'll need to provide your own API keys for commercial LLM providers, which may have associated costs.
Can Easy Agent integrate with MCP servers?+
Yes, Easy Agent includes MCP protocol support (added in Stage 16) allowing it to integrate external tools and resources from any MCP server. Configure MCP servers in your settings file and they become available as tools within the agent.
How do I install easy-agent?+
Open the source repository on GitHub and follow its README. easy-agent is a agent — MCP Agents Market links you directly to the official repo.
Is easy-agent free?+
easy-agent is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.