agent-stack-manager-cli

agent-stack-manager-cli is a local CLI for managing skill, mcp, and rule resources as reusable bundles, then projecting them into project-level AI configuration for Claude and Cursor.

After installation, the command name is:

agentctl

Install

npm

npm i -g agent-stack-manager-cli

pnpm

pnpm add -g agent-stack-manager-cli

Then verify:

agentctl --help

The package is prepared for npm distribution and has been verified locally with:

• pnpm typecheck
• pnpm test
• pnpm build
• pnpm pack
• fresh global install from the generated .tgz

What It Supports

Current MVP scope:

• Resource types: skill, mcp, rule
• Install/projection targets: Claude, Cursor
• Scope: project
• Source types: local, git
• Install constraint: one bundle per target platform

Quick Start

1. Initialize a project

agentctl init

2. Register a skill

agentctl add skill --local ./skills/summarize

3. Register an MCP server

agentctl add mcp --local ./mcp/source.json

agentctl add mcp supports both:

• standard MCP config files with a top-level mcpServers object, including .mcp.json / .cursor/mcp.json-style JSON
• the legacy single-resource manifest shape with top-level server and optional platformConfig

When a standard MCP config file contains multiple servers, the CLI shows a checkbox prompt in interactive terminals so you can select one or more servers with space + Enter. In non-interactive environments it falls back to the existing text input flow.

4. Create a bundle

agentctl bundle create ai-coding-pack
agentctl bundle add ai-coding-pack summarize

5. Install into Claude

agentctl install ai-coding-pack --target claude

6. Inspect current state

agentctl status
agentctl list
agentctl diff --target claude
agentctl doctor --target claude

Implemented Commands

Available now:

• agentctl init
• agentctl status
• agentctl add
• agentctl remove
• agentctl bundle create
• agentctl bundle add
• agentctl bundle remove
• agentctl list
• agentctl install --dry-run
• agentctl install
• agentctl uninstall
• agentctl diff
• agentctl doctor

Not Included Yet

Not implemented in the current release:

• user scope
• registry-backed distribution
• multi-bundle per target
• advanced rule conflict inference

Local Release Check

Before publishing:

pnpm install
pnpm release:check

For the full maintainer release workflow, see RELEASE.md.

The repository also includes GitHub Actions CI for regular validation on push and pull request.

This runs:

• pnpm typecheck
• pnpm test
• pnpm build
• pnpm pack

Local Package Trial

You can test the packed tarball before publishing:

pnpm pack

Then install the generated .tgz in a clean environment and run:

agentctl --help
agentctl init
agentctl status

The current release check confirmed that the packed tarball only contains:

• dist/
• README.md
• LICENSE
• package.json

Development Docs

If you are contributing to the project or extending the CLI implementation, start with:

• CHANGELOG.md
• RELEASE.md
• CLAUDE.md
• docs/pre-build-rules-baseline.md
• docs/schema-draft.md
• docs/adapter-contract.md
• docs/platform-mapping-claude-cursor.md