[ PROMPT_NODE_22171 ]
Agent Management
[ SKILL_DOCUMENTATION ]
# 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](https://github.com/23blocks-OS/ai-maestro) suite.
## Prerequisites
Requires [AI Maestro](https://github.com/23blocks-OS/ai-maestro) running locally with tmux 3.0+.
```bash
# 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 ` | Detailed agent information |
| `aimaestro-agent.sh create --dir ` | Create new agent |
| `aimaestro-agent.sh update --task "..."` | Update task/tags |
| `aimaestro-agent.sh delete --confirm` | Delete agent |
| `aimaestro-agent.sh rename ` | Rename agent |
| `aimaestro-agent.sh hibernate ` | Save state, free resources |
| `aimaestro-agent.sh wake ` | Resume hibernated agent |
| `aimaestro-agent.sh restart ` | Hibernate then wake |
### Plugin Management
| Command | Description |
|---------|-------------|
| `aimaestro-agent.sh plugin install ` | Install plugin |
| `aimaestro-agent.sh plugin uninstall ` | Remove plugin |
| `aimaestro-agent.sh plugin list ` | List installed plugins |
| `aimaestro-agent.sh plugin marketplace add ` | Add marketplace |
### Export/Import
| Command | Description |
|---------|-------------|
| `aimaestro-agent.sh export ` | Export agent config |
| `aimaestro-agent.sh import ` | Import agent from file |
## Usage Examples
```bash
# 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](https://github.com/23blocks-OS/ai-maestro) platform, which provides **6 skills** for AI agent orchestration: messaging, memory, docs, graph, planning, and agent management.