본문으로 건너뛰기
TakoAPI
스킬로 돌아가기
—아직 평가 없음
내 평가

요약

Aider WebUI is a modern web interface for Aider CLI, built on the NiceGUI framework. The application provides a split-view interface (Terminal + Chat) that allows users to interact with Aider through a browser instead of a plain terminal. Aider WebUI comes with a built-in mini file browser, enabling users to manage their Aider context conveniently.

설명

# Aider WebUI

<p align="center">
  <img src="https://img.shields.io/pypi/v/aider-webui?color=blue&label=PyPI" alt="PyPI Version">
  <img src="https://img.shields.io/pypi/pyversions/aider-webui" alt="Python Versions">
  <img src="https://img.shields.io/github/license/LX-Aider/aider-webui" alt="License">
  <img src="https://img.shields.io/pypi/dm/aider-webui?color=green" alt="Downloads">
</p>

<p align="center">
  A modern, browser-based interface for <a href="https://aider.chat">Aider CLI</a> — combining a clean <strong>Chat UI</strong> with a fully functional <strong>Terminal Emulator</strong> in a split-view layout.
</p>

---

## ✨ Features

| Feature | Description |
|---|---|
| 💬 **Chat History** | Clean Markdown rendering of AI conversations — no ANSI noise |
| ⬛ **Full Terminal** | Real `xterm.js` terminal with ANSI colors, progress bars & Git diff |
| 🔀 **Split View** | Resizable panels for Chat and Terminal side-by-side |
| 🔒 **State Sync** | Input automatically locks while Aider is processing |
| 📁 **File Picker** | Tree-based file browser for `/add`, `/read-only`, `/run` commands |
| 🧩 **Session Isolation** | Each browser tab gets its own independent PTY process |
| ⚙️ **Env Config** | Override API base URLs and keys via `.env` — ideal for team proxy setups |

---

## 🚀 Installation

```bash
pip install aider-webui
```

---

## 📖 Quick Start

**1.** Make sure [Aider](https://aider.chat) is installed and accessible in your `PATH`:

```bash
pip install aider-chat
```

**2.** *(Optional)* Create a `.env` file in your project directory:

```env
# .env
AIDER_COMMAND=aider
WORKING_DIR=.
ANTHROPIC_API_KEY=sk-ant-...
```

**3.** Launch Aider WebUI:

```bash
aider-webui
```

**4.** Open your browser at **[http://localhost:8080](http://localhost:8080)**

---

## ⚙️ Configuration

All configuration is done via environment variables (or a `.env` file in your working directory).

| Variable | Default | Description |
|---|---|---|
| `AIDER_COMMAND` | `aider` | Command used to launch Aider CLI |
| `WORKING_DIR` | `.` | Working directory for Aider process |
| `HOST` | `0.0.0.0` | Host address to bind the web server |
| `PORT` | `8080` | Port to run the web server |
| `ANTHROPIC_API_KEY` | *(none)* | Anthropic API key (or set in your shell) |
| `OPENAI_API_KEY` | *(none)* | OpenAI API key (or set in your shell) |
| `ANTHROPIC_BASE_URL` | *(none)* | Override Anthropic base URL (e.g. internal proxy) |
| `OPENAI_BASE_URL` | *(none)* | Override OpenAI base URL (e.g. internal proxy) |

> **Tip:** Use `ANTHROPIC_BASE_URL` / `OPENAI_BASE_URL` to route API calls through an internal gateway — keeping API keys secure when sharing the WebUI across a team network.

---

## 🏗️ Architecture

Aider WebUI uses a **Dual Data Flow** design to cleanly separate raw terminal output from structured chat history:

```
Browser
├── xterm.js (Terminal)  ──WebSocket──▶  PTY Manager ──stdin/stdout──▶  Aider CLI
│                                                                              │
└── Chat UI (Markdown)  ◀──delta text──  File Poller  ◀──polls 500ms──  .aider.chat.history.md
```

- **Real-time flow** — raw PTY output streamed directly to `xterm.js` over WebSocket
- **Chat flow** — Aider's chat history file polled every 500ms, cleaned, and rendered as Markdown

---

## 🛠️ Development

**Clone and set up:**

```bash
git clone https://github.com/LX-Aider/aider-webui.git
cd aider-webui
python -m venv .venv
.venv\Scripts\activate  # Windows
pip install -e ".[dev]"
```

**Run locally:**

```bash
aider-webui
# or
python -m aider_webui
```

**Run tests:**

```bash
pytest
```

---

## 🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch: `git checkout -b feat/your-feature`
3. Commit your changes following [Conventional Commits](https://www.conventionalcommits.org/)
4. Open a Pull Request

---

## 📄 License

This project is licensed under the [MIT License](LICENSE).

설치

https://github.com/leandix-ai/aider-webui에서 스킬을 설치해줘

이 스킬은 ClawHub 레지스트리에 게시되지 않았습니다. 프롬프트를 코딩 에이전트(Claude Code, Cursor, Codex)에 붙여넣으면 소스 저장소에서 바로 스킬을 설치합니다.

저장소 열기

링크