| name | agent-management |
| description | 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. |
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+.
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
aimaestro-agent.sh create backend-api \
--dir ~/projects/backend \
--task "Build REST API with TypeScript" \
--tags "api,typescript"
aimaestro-agent.sh hibernate frontend-ui
aimaestro-agent.sh hibernate data-processor
aimaestro-agent.sh wake frontend-ui --attach
aimaestro-agent.sh plugin install backend-api my-plugin
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.
