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.
$ npx claude-code-templates@latest --skill="ai-maestro/agent-management" --yesRequires Claude Code. The command adds this skill to your project's .claudedirectory — nothing runs on ToolZip's servers.
What's inside this skill
Component source
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.
Related Claude Code Skills
Planning
Create and manage persistent markdown planning files for structured task execution. Use when the user asks to "create a plan", "track progress", "start a research project", or when a task requires more than 5 tool calls and needs structured phase tracking to stay focused and avoid goal drift.
Memory Search
Search conversation history and semantic memory to recall previous discussions, decisions, and context. Use when the user asks to "search memory", "what did we discuss", "remember when", "find previous conversation", "check history", or before starting work to recall prior decisions.
Agent Messaging
Send and receive cryptographically signed messages between AI agents using the Agent Messaging Protocol (AMP). Use when the user asks to "send a message to an agent", "check agent inbox", "message another agent", "reply to a message", "notify an agent", or any inter-agent communication task.
Docs Search
Search auto-generated codebase documentation for function signatures, API docs, class definitions, and code comments. Use when the user asks to "search docs", "find documentation", "look up a function", "check the API", or before implementing changes to verify correct signatures and patterns.
Graph Query
Query the code graph database to understand component relationships, dependencies, and change impact. Use when the user asks to "find callers", "check dependencies", "what uses this", "show relationships", "find serializers", or when reading code and needing to understand what depends on a component before modifications.
Frontend Design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
Catalog data and component content are sourced from the open-source davila7/claude-code-templates project (MIT license). ToolZip curates the listing and writes original descriptions; every component links back to its original source. Claude Code is a product of Anthropic. ToolZip is an independent catalog and is not affiliated with or endorsed by Anthropic.