Introduction

Aura finds configuration drift between the coding agents on your machine and gives you one safe plan to repair it. Use it when Claude Code, Codex, and Cursor should share instructions, skills, and MCP servers without maintaining the same configuration three times.

The problem Aura solves

Imagine a repository with these three states:

Application	Instructions	Skills	MCP servers
Claude Code	Loads the team rules	Has review	Has GitHub
Codex	Loads an older rules file	Missing review	Has GitHub
Cursor	Loads no shared rules	Has a stale review	Missing GitHub

Aura reads each application’s configuration into one model and reports the differences. When a finding can be repaired, Aura builds a file plan, shows it to you, and waits for confirmation.

The short version

Aura is a configuration doctor, not another coding agent. It helps the agents you already use agree on shared instructions, skills, and MCP servers.

What Aura can do

Inspect

Detect supported applications and explain configuration, authentication, instruction, skill, and MCP findings.

Converge

Consolidate shared instructions and apply reviewed skills and MCP selections through one previewable plan.

Recover

Back up successful writes, roll back failed transactions, and restore an earlier change with aura undo.

What Aura writes

Aura manages personal configuration below ~/agents and the global configuration of applications you select. It may inspect repository files for diagnostics, but setup, fixes, and undo do not modify the current repository.

Every write goes through the same safety path:

1. Aura reads and validates the current files.
2. It shows one combined plan; add --detail when you need the complete diff.
3. It checks that the files did not change after the preview.
4. It writes atomically and records a backup for aura undo.

Plugins are trusted code

Plugins run with the privileges of the Aura process. Install a plugin with the same care you apply to any other dependency. Aura makes plugin fixes previewable; it does not sandbox plugin code.

Choose your path

Run Aura for the first timeInstall, preview setup, converge, verify, and learn how to undo.

Configure a teamCommit repository-owned snippets, skills, and MCP definitions.

Extend AuraCompose a branded distribution from trusted plugins.