wess

Ainz — AI skill for Claude Code

AI community

A flexible, customizable, performant, secure and a little retro AI Agent Harness magic.

How to install Ainz

This entry records only its repository, not the path inside it, so there is no exact command to give. Open wess/ainz and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Ainz does

A flexible, customizable, performant, secure and a little retro AI Agent Harness magic.

Alternatives in AI

Impeccable — The design language that makes your AI harness better at design 13.9k ★
ARIS Agent Guide — For AI agents reading this repo 6.2k ★
Ccstatusline — by sirmalloc - A highly customizable status line formatter for Claude Code CLI that displays model info, git b 5.5k ★

README

Ainz

Ainz is a small agent harness built in Rust on Tokio. The model loop, tools, session history, and extensions are library primitives; the terminal interface is one consumer of them, alongside one-shot, JSON event stream, and JSON-RPC modes.

It talks to OpenAI-compatible chat-completions endpoints with streaming and tool calls, including a LiteLLM proxy, and to headless coding CLIs as process providers. Sessions are resumable trees with automatic, branch-aware compaction. Tools cover workspace read, list, search, write, edit, and shell, reading a URL, a plan the session keeps as it works, durable background jobs, lazily loaded skills, prompt templates, subagents, MCP servers over stdio and Streamable HTTP, and content-pinned Lua, WebAssembly component, or process plugins. Sessions remember across runs: durable memory kept locally or in Synapse, search over earlier sessions, and skills a session writes for the next one.

Install

With Homebrew on macOS or Linux:

brew install wess/packages/ainz

With the checksum-verifying installer:

curl --proto '=https' --tlsv1.2 -LsSf \
  https://raw.githubusercontent.com/wess/ainz/main/install.sh | sh

Release downloads cover Apple Silicon macOS and x86_64 and arm64 Linux. The `search` tool shells out to [ripgrep](https://github.com/BurntSushi/ripgrep), so install `rg` as well. See [`docs/install.md`](docs/install.md) for pinned versions, custom install directories, Cargo, and uninstalling. The [documentation index](docs/readme.md) lists every guide. The project site has a [tutorial](https://wess.io/ainz/tutorial/) and [reference manual](https://wess.io/ainz/docs/).

Ainz was previously called AgentX. On first launch it carries forward the configuration and MCP profile from the old user directory, and it keeps discovering sessions, headers, prompts, skills, plugins, and plugin approvals written under the old name while new state is written under `ainz` and `.ainz`. The `AGENTX_*` environment variabl