The Package Manager & Workspace Orchestrator for AI Workflow Assets.
Quickstart • Architecture • Commands • Imports • Documentation
Status: Early public release, currently installed from source. Core install, lock, sync, import, and registry workflows are available, while formats and commands may still evolve before 1.0.
Most developers have custom Agent Skills, System Prompts, and Model Context Protocol (MCP) server configurations scattered across private folders, Gists, and random repositories.
aman brings package-manager ergonomics to AI workflows: install, lock, sync, and share skills and tool configs across machines and IDEs with reproducible aman.lock files.
┌──────────────────────────────────────────────┐
│ Aman Workflow Ecosystem │
└──────────────────────┬───────────────────────┘
│
┌──────────────────┬──────────────┴─────┬──────────────────┐
▼ ▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Agent Skills │ │ Task Prompts │ │ MCP Servers │ │ Stacks/Packs │
│ (SKILL.md) │ │ (PROMPT.md) │ │ (mcp.json) │ │ (.amanpack) │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
| Asset Type | Canonical Format | What It Does |
|---|---|---|
| Skills | skills/<name>/SKILL.md |
Reusable procedural instructions, tools, and workflows for coding agents. |
| Prompts | prompts/<name>/PROMPT.md |
System-level prompt templates with parameter substitution. |
| MCPs | mcps/<name>/mcp.json |
Model Context Protocol servers, transport settings, and environment secrets. |
| Packs | .amanpack archives |
Shareable, compressed bundles combining skills, prompts, and server configs. |
| Stacks | Named manifest sets | Pre-configured environment setups combining related skills and tool servers. |
git clone https://github.com/amandeavor/Aman-CLI.git
cd Aman-CLI
npm ci
npm run build
npm link
aman --version# Initialize in current project
aman init --local
# Or initialize global developer profile
aman init --globalaman doctor| Command | Description |
|---|---|
aman init [--local | --global] |
Initializes an Aman environment directory with .aman/ configuration and lockfile. |
aman install <package> |
Installs an asset package or stack with cryptographic dependency resolution. |
aman import [adapter] |
Discovers and imports existing rules and MCPs from Claude Code, Cursor, Windsurf, or Antigravity. |
aman doctor |
Performs static pre-flight diagnostics (node version, lockfiles, secret isolation, layout rules). |
aman pack <name> |
Compiles an asset directory into a distributable .amanpack archive. |
aman sync |
Synchronizes active workspace assets with a remote GitHub storage profile. |
aman can automatically extract and normalize skills and MCP servers from existing IDEs and agent runners:
# Interactive import wizard
aman import
# Direct imports from configured editors
aman import cursor --global
aman import antigravity --global
aman import ./local-skills-folder --global
aman import owner/repo --globalSee docs/IMPORT-GUIDE.md for detailed instructions covering Claude Code, Cursor, Windsurf, Continue.dev, Copilot, Codex, and Antigravity.
| Guide | Description |
|---|---|
| Quickstart Guide | Step-by-step walkthrough from initial setup to first installed skill. |
| Import Guide | Multi-IDE discovery and migration manual. |
| Asset Specification | Standard directory layout, metadata schema, and validation rules. |
| Registry Specification | Package publishing, versioning, and distribution contract. |
| Lockfile Specification | Reproducible environment schema for aman.lock. |
| Aman Constitution | Core architectural principles and local-first data guarantees. |
| Contributing Guide | Local development, test suites, and PR standards. |
| Security Policy | Secret isolation (mcp.local.json) and vulnerability reporting. |
| Project Roadmap | Planned capabilities, transports, and registry milestones. |
This project is licensed under the MIT License.