aman-claude-code

The complete AI companion plugin for Claude Code.

Auto-loads your identity, memory, tools, workflows, guardrails, and skills — every session, zero setup.

Install · Features · How to use · Troubleshooting · Ecosystem · Updating

⚠️ Renamed from aman-plugin (v3.0.0)

This plugin was previously published as aman-plugin. Starting with v3.0.0 it's renamed to aman-claude-code for consistency with the rest of the ecosystem (aman-copilot, aman-cursor in the roadmap, etc.). The GitHub repo amanasmuei/aman-plugin auto-redirects to amanasmuei/aman-claude-code, so clones and bookmarks still work.

Existing users: reinstall under the new name:

claude plugin uninstall aman-plugin@aman
claude plugin marketplace remove aman
claude plugin marketplace add amanasmuei/aman-claude-code
claude plugin install aman-claude-code@aman

Your acore/arules/amem data at ~/.acore, ~/.arules, ~/.amem is untouched — only the plugin wrapper is renamed. See CHANGELOG.md for the full migration guide and rationale.

Why this exists

Even with the aman ecosystem set up, you still have to manually inject identity files, remember which slash commands do what, and manage platform config files. The gap between "ecosystem configured" and "AI actually loads it" is annoying. aman-claude-code bridges that gap for Claude Code. Install once, and your full AI ecosystem loads automatically every session — identity, rules, memory, tools, workflows, and skills. No CLAUDE.md injection. No manual setup per project.

Install

1. Requirements

2. Set up the aman ecosystem + install the plugin

Run the one-shot ecosystem installer, then add the plugin:

# Set up identity, guardrails, and eval
npx @aman_asmuei/aman@latest

# Register the marketplace and install the plugin
claude plugin marketplace add amanasmuei/aman-claude-code
claude plugin install aman-claude-code@aman

# Install live MCP tools (read/write during sessions)
node ~/.claude/plugins/cache/aman/aman-claude-code/*/bin/install-mcp.mjs

The aman@latest wizard walks you through acore (identity), arules (guardrails), and aeval (relationship tracking). The plugin install wires a SessionStart hook that fires on every session start, resume, clear, and compact. The install-mcp.mjs step is idempotent and preserves any other MCP servers in your config.

npx @aman_asmuei/acore@latest            # identity    → ~/.acore/dev/plugin/core.md
npx @aman_asmuei/arules@latest init      # guardrails  → ~/.arules/dev/plugin/rules.md
npx @aman_asmuei/aeval@latest init       # evaluation
npx @aman_asmuei/akit@latest add github  # (optional) tools
npx @aman_asmuei/aflow@latest init       # (optional) workflows

git clone https://github.com/amanasmuei/aman-claude-code ~/aman-claude-code
claude plugin marketplace add ~/aman-claude-code
claude plugin install aman-claude-code@aman