Wardian

# Wardian

<div align="center">

<img src="public/icon.png" width="128" alt="Wardian Logo" />

**Where local agent work becomes visible, durable, and malleable.**

Run CLI agents across all your workspaces, keep their sessions and evidence
visible, and turn successful work into reusable prompts, skills, classes,
workflows, and project context.

[![tests](https://github.com/wardian-app/Wardian/actions/workflows/ci.yml/badge.svg)](https://github.com/wardian-app/Wardian/actions/workflows/ci.yml)
[![Coverage](https://codecov.io/gh/wardian-app/Wardian/branch/main/graph/badge.svg)](https://codecov.io/gh/wardian-app/Wardian)
[![Release](https://img.shields.io/github/v/release/wardian-app/Wardian?label=release)](https://github.com/wardian-app/Wardian/releases/latest)
[![Downloads](https://img.shields.io/github/downloads/wardian-app/Wardian/total?label=downloads)](https://github.com/wardian-app/Wardian/releases)
[![Discord](https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white)](https://discord.gg/dVF9PgqwnT)
![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-555)

[![Wardian Demo](public/demo.gif)](public/demo.gif)

</div>

---

> 🚧 **Early development.** Wardian is under active construction. Expect rough edges: CLIs, on-disk formats, and UI layouts can change between releases without notice. Pin a version if you depend on it, and please [file an issue](https://github.com/wardian-app/Wardian/issues) when something breaks.

Wardian gives the agent tools you already run durable identity, live terminals, scoped skills, workflow runs, queue evidence, and workspace context in one GUI-first habitat.

Use it to spawn specialized agents, monitor their progress, hand work between them, collect completed output, and automate repeatable flows across providers such as Antigravity, Claude, Codex, OpenCode, and Pi. The bundled `wardian` CLI gives agents and scripts a textual control surface for discovering identity, coordinating peers, and controlling Wardian without driving the graphical app.

Wardian is built for malleable agent work. Prompts, classes, skills, workflows, queues, and memory-ready evidence are treated as visible, reusable artifacts rather than opaque app state. Its tab-based Workbench lets surfaces move between panes, split side by side, and restore across launches while the agent roster and auxiliary tools remain available. You can start by watching live agents, then gradually turn repeated instructions into prompts, reusable roles, deployable skills, workflow templates, and durable project context.

---

## Install

Use the supported install path for your platform:

| System | Install |
| :--- | :--- |
| Windows x64 | `winget install WardianApp.Wardian` |
| macOS Apple Silicon or Intel | `brew install --cask wardian-app/tap/wardian` |
| Linux Debian/Ubuntu x64 | Download `Wardian_X.Y.Z_amd64.deb` from [Releases](https://github.com/wardian-app/Wardian/releases/latest), then run `sudo apt install ./Wardian_X.Y.Z_amd64.deb`. |
| Linux other x64 | Download `Wardian_X.Y.Z_amd64.AppImage` from [Releases](https://github.com/wardian-app/Wardian/releases/latest), then run `chmod +x Wardian_X.Y.Z_amd64.AppImage && ./Wardian_X.Y.Z_amd64.AppImage`. |

Manual downloads are also available from the [Releases page](https://github.com/wardian-app/Wardian/releases).
Choose the asset for your operating system and CPU:

| System | Download asset | Notes |
| :--- | :--- | :--- |
| Windows x64 | `Wardian_X.Y.Z_x64-setup.exe` | Standard Windows installer. |
| macOS Apple Silicon | `Wardian_X.Y.Z_aarch64.dmg` | For M-series Macs such as M1, M2, M3, or M4. |
| macOS Intel | `Wardian_X.Y.Z_x64.dmg` | For older Intel Macs. |
| Linux Debian/Ubuntu x64 | `Wardian_X.Y.Z_amd64.deb` | Installable Debian package. |
| Linux other x64 | `Wardian_X.Y.Z_amd64.AppImage` | Portable Linux app. |

`x64` and `amd64` both mean 64-bit Intel/AMD CPUs. On macOS, Apple Silicon uses `aarch64`, not `x64`. Ignore updater-only assets such as `latest.json`, `.app.tar.gz`, or `.sig` files when installing manually.

Debian/Ubuntu users who want package-manager updates can use the optional
[Wardian APT repository](docs/developer/package-manager-distribution.md#linux-apt-repository).

> **macOS:** Official releases built by the signed release workflow are Developer ID signed and Apple-notarized. Open the DMG, drag Wardian to **Applications**, eject the DMG, then launch the copy in **Applications**. Do not run Wardian directly from the mounted DMG: it is read-only and in-app updates cannot replace an app there.
>
> **Windows:** SmartScreen can show a reputation warning for a new release. Continue only when the installer came from the official Wardian release you intended to install.
>
> **Linux:** APT installs update through the system package manager. `.AppImage` is portable (`chmod +x` and run); direct `.deb` downloads install via `sudo apt install ./Wardian_*.deb`.

---

## Table of Contents

- [Quick Start](

... (truncated)