EasyShell

EasyShell

AI-Native Server Operations Platform

Let AI write your scripts, orchestrate multi-host tasks, and analyze your infrastructure — while you focus on what matters.

Language: English | 简体中文 | 繁體中文 | 한국어 | Русский | 日本語

Why EasyShell?

Traditional server management tools expect you to write every script, SSH into every box, and interpret every output yourself. EasyShell flips that model: AI is the operator, you are the decision-maker.

• Describe what you need in plain language → AI writes production-ready shell scripts with diff review
• Set a goal across multiple hosts → AI plans the execution steps, runs them, and synthesizes the results
• Schedule automated inspections → AI analyzes output and decides whether to alert your team via bot channels
• Connect via Web SSH → Full terminal with file manager, multi-tab, search — no local client needed

Core Features

1. AI Script Assistant

Describe what you want. AI writes the script. Review the diff. One click to apply.

The AI Script Workbench is a split-panel editor where you describe requirements in natural language, and AI generates (or modifies) shell scripts targeting your chosen OS. Real-time streaming shows the script being written. A built-in diff view highlights exactly what changed. A summary tab explains the modifications in your language.

How it works:

1. Describe — write your requirements in natural language, choose the target OS
2. Generate — AI streams a production-ready script in real time
3. Review — built-in diff view highlights every change; summary tab explains modifications
4. Apply — one click to save the script to your library or dispatch it immediately

2. AI Task Orchestration

"Check disk and memory on all hosts, flag anything over 80%, and suggest fixes." — Done.

The AI Chat interface lets you issue high-level operational goals. AI decomposes them into a multi-step execution plan (explore → analyze → report), dispatches scripts to target hosts, collects results, and delivers a structured analysis with risk assessment and actionable recommendations — all in a single conversation turn.

How it works:

1. Instruct — describe a high-level goal in the AI Chat (e.g. "check disk on all hosts")
2. Plan — AI decomposes the goal into a multi-step execution plan (explore → analyze → report)
3. Execute — scripts are dispatched to target hosts in parallel; results collected automatically
4. Report — AI delivers a structured analysis with risk assessment and actionable recommendations

3. AI Scheduled Inspections

Cron → Script → AI Analysis → Intelligent Alert — AI analyzes output and decides whether to alert your team.

Schedule inspection tasks with cron expressions and select scripts from the built-in script library. EasyShell dispatches them to agents on schedule, collects output (disk, memory, services, logs), sends it to your AI model for intelligent analysis, and lets AI decide whether the results warrant an alert — pushing notifications only when they matter.

How it works:

1. Configure — cron expression + script (from library or custom) + AI analysis prompt + notification rules
2. Execute — EasyShell dispatches to target agents on schedule
3. Analyze — Output sent to AI model (OpenAI / Gemini / GitHub Copilot / Custom) for intelligent analysis
4. Notify — AI determines severity and pushes alerts via bot channels when action is needed

Notification modes: Always push, push on failure, push on warning, or AI decides — the AI model evaluates the output and autonomously determines if an alert is necessary.

Supported Bot Channels (Configuration Guide):

4. Fully Functional Web SSH

Real terminal. Real file manager. No SSH client required.

A production-grade web terminal with multi-tab sessions, integrated file manager (upload, download, create, delete, navigate), full-text search within terminal buffer, and persistent connections via WebSocket. Manage files and run commands side by side.

5. Host Management & Monitoring

Unified view of all servers with real-time status, batch operations, and agent lifecycle management.

Manage hosts individually or in bulk — add via form or CSV import, organize into clusters, monitor connection status, and deploy/upgrade agents with one click. The unified dashboard shows health metrics at a glance.

6. Real-Time Streaming Logs

Watch script execution unfold live across all target hosts.

When you dispatch a script, EasyShell streams output from every agent in real time. Color-coded logs, timestamps, and per-host filtering help you spot issues instantly — no more waiting for batch jobs to complete.

7. Security & Risk Controls

Built-in safeguards: approval workflows, audit trails, and operation restrictions.

Configure which operations require approval before execution. All actions are logged for compliance. Role-based access control limits who can do what, and sensitive commands can be flagged or blocked entirely.

Quick Start

git clone https://github.com/easyshell-ai/easyshell.git
cd easyshell
cp .env.example .env      # Edit .env if needed
docker compose up -d

No local build required — pre-built images are pulled automatically from Docker Hub.

Open http://localhost:18880 → login with easyshell / easyshell@changeme.

Want to use GHCR instead? Set in .env:

EASYSHELL_SERVER_IMAGE=ghcr.io/easyshell-ai/easyshell/easyshell-server:latest
EASYSHELL_WEB_IMAGE=ghcr.io/easyshell-ai/easyshell/easyshell-web:latest

Developer? Build from source:

docker compose -f docker-compose.build.yml up -d

Full Feature Set

Architecture

┌──────────────┐       HTTP/WS        ┌──────────────────┐
│  EasyShell   │◄─────────────────────►│   EasyShell      │
│    Agent     │  register / heartbeat │     Server       │
│  (Go 1.24)  │  script exec / logs   │ (Spring Boot 3.5)│
└──────────────┘                       └────────┬─────────┘
                                                │
                                       ┌────────┴─────────┐
                                       │   EasyShell Web   │
                                       │ (React + Ant Design)│
                                       └──────────────────┘

Tech Stack

Project Structure

easyshell/
├── easyshell-server/           # Central management server (Java / Spring Boot)
├── easyshell-agent/            # Agent client (Go, single binary)
├── easyshell-web/              # Web frontend (React + Ant Design)
├── docker-compose.yml          # Production deployment (pulls pre-built images)
├── docker-compose.build.yml    # Development (local build from source)
├── Dockerfile.server           # Server + Agent multi-stage build
├── Dockerfile.web              # Web frontend multi-stage build
├── .github/workflows/          # CI/CD: build & publish Docker images
└── .env.example                # Environment configuration template

Documentation

Visit docs.easyshell.ai for:

• Installation & deployment guide
• Getting started walkthrough
• Configuration reference
• Development guide

Community

Join our Discord community for support, discussions, and updates:https://discord.gg/WqFD9VQe

License

This project is licensed under the MIT License.