SKILL #MENT

agent-management

Create, manage, and orchestrate AI agents using the AI Maestro CLI. Use when the user asks to "create agent", "list agents", "delete agent", "hibernate agent", "wake agent", "install plugin", "show agent", "restart agent", or any agent lifecycle management task.

↗ github · ★ 27k·src: davila7/claude-code-templates

the manual

AI Maestro Agent Management

Create, manage, and orchestrate multiple AI agents through a unified CLI. Handles the full agent lifecycle: create, hibernate, wake, rename, export/import, and plugin management. Part of the AI Maestro suite.

Prerequisites

Requires AI Maestro running locally with tmux 3.0+.

# Install the CLI
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-agent-cli.sh

Core Commands

Agent Lifecycle

Command	Description
`aimaestro-agent.sh list`	List all agents with status
`aimaestro-agent.sh show <agent>`	Detailed agent information
`aimaestro-agent.sh create <name> --dir <path>`	Create new agent
`aimaestro-agent.sh update <agent> --task "..."`	Update task/tags
`aimaestro-agent.sh delete <agent> --confirm`	Delete agent
`aimaestro-agent.sh rename <old> <new>`	Rename agent
`aimaestro-agent.sh hibernate <agent>`	Save state, free resources
`aimaestro-agent.sh wake <agent>`	Resume hibernated agent
`aimaestro-agent.sh restart <agent>`	Hibernate then wake

Plugin Management

Command	Description
`aimaestro-agent.sh plugin install <agent> <plugin>`	Install plugin
`aimaestro-agent.sh plugin uninstall <agent> <plugin>`	Remove plugin
`aimaestro-agent.sh plugin list <agent>`	List installed plugins
`aimaestro-agent.sh plugin marketplace add <agent> <source>`	Add marketplace

Export/Import

Command	Description
`aimaestro-agent.sh export <agent>`	Export agent config
`aimaestro-agent.sh import <file>`	Import agent from file

Usage Examples

# Create a backend API agent
aimaestro-agent.sh create backend-api \
  --dir ~/projects/backend \
  --task "Build REST API with TypeScript" \
  --tags "api,typescript"

# End of day -- save resources
aimaestro-agent.sh hibernate frontend-ui
aimaestro-agent.sh hibernate data-processor

# Resume next morning
aimaestro-agent.sh wake frontend-ui --attach

# Install a plugin on an agent
aimaestro-agent.sh plugin install backend-api my-plugin

# Backup before risky changes
aimaestro-agent.sh export backend-api -o backup.json

Agent Statuses

Status	Meaning
`online`	Running in tmux session
`offline`	Registered but no active session
`hibernated`	Saved state, session killed

Full AI Maestro Experience

This skill is part of the AI Maestro platform, which provides 6 skills for AI agent orchestration: messaging, memory, docs, graph, planning, and agent management.