Aru

aru

**Keep coding-agent instructions, skills, and MCP servers in sync across your project.**

Aru gives your team one project manifest, one reproducible lockfile, and safe projections for every supported coding agent.

[Documentation](https://narumiruna.github.io/aru/) · [Getting started](https://narumiruna.github.io/aru/getting-started/) · [Command reference](https://narumiruna.github.io/aru/reference/commands/) · [Source](https://github.com/narumiruna/aru)

[!WARNING] Aru is under active development. Features, behavior, and file formats may change before 1.0.

Why aru?

Projects often repeat the same setup for Codex, Claude Code, GitHub Copilot, pi, OpenCode, and other agents.

Aru lets you declare that setup once:

• Keep existing AGENTS.md files as the canonical instructions.
• Install Agent Skills from Git repositories.
• Configure MCP servers without storing secret values.
• Reuse native aru packages that bundle instructions, skills, and trusted MCP declarations.
• Resolve selected skills and safe MCP from Agent Plugins, OpenAI plugins, and Gemini extensions.
• Pin exact revisions and projections in aru.lock.
• Detect drift and unmanaged content before replacing anything.

Aru supports full project adapters plus project-scoped skill-only targets.

Target class	Examples	Capability
Full adapters	codex, claude, copilot, opencode	Instructions, skills, and MCP
Native instruction adapters	agents, pi	Instructions and skills
Skill-only adapters	cursor, gemini, kiro, windsurf, and others	Skills only

Run `aru target list --available` for every canonical target, project skill path, capability, and accepted alias. Aliases such as `claude-code`, `gemini-cli`, and `kiro-cli` normalize to short canonical names before persistence.

Install

Aru requires a system `git` executable.

macOS and Linux

The recommended installer downloads a prebuilt, checksum-verified binary to `~/.local