Easy Agent

A terminal coding agent that reads your code, edits files, and runs commands under permission rules you control.

Easy Agent (eagent) runs in your terminal next to your repository. Describe a task and it plans the work, reads and changes files, runs tests or shell commands, and reports back. Every action that can change your machine goes through permission rules, workspace trust, and an optional OS-level sandbox. It works with Anthropic, OpenAI-compatible, Gemini, and local models.

The code is written to be read as well as run. Model communication, the agentic loop, tools, permissions, context management, and each extension system live in separate layers. The documents linked below explain how the security-relevant parts behave and why, and the learning path walks through the layers in order with code snapshots, which helps if you want to build or customize an agent of your own.

中文文档：README.zh-CN.md

What you can use it for

• Find your way around an unfamiliar codebase: ask where something is handled, how a flow works, or what a change would touch.
• Make multi-file changes, review the diff, and undo them with /rewind if they are wrong.
• Run builds and tests, read the failures, and iterate on a fix.
• Plan a change first in read-only Plan Mode, then carry it out.
• Script it: pipe input into eagent -p and read text, JSON, or NDJSON output in CI or shell scripts.
• Connect your own tools through MCP servers, skills, custom agents, hooks, and plugins.

Install

Requirements: Node.js 22 or newer, npm, and credentials for at least one supported model provider.

npm install -g --ignore-scripts eagent
eagent --version

Or try it without installing:

npx --yes eagent@latest

On macOS and Linux an installer is also available. It checks Node.js, installs the same npm package with --ignore-scripts, and verifies that eagent is on PATH. It does not install Node.js or run package lifecycle scripts.

curl -fsSL https://raw.githubusercontent.com/ConardLi/easy-agent/main/install.sh | sh

The package installs two commands, eagent and the long alias easy-agent.

Quick start

export ANTHROPIC_AUTH_TOKEN="your-token"
cd your-project
eagent

On first use in a folder, Easy Agent asks whether you trust it. Then type a request, for example explain how requests are authenticated in this repo. Type /help for commands; press Ctrl+D to exit.

Core capabilities