agent-management

1# AI Maestro Agent Management
2 
3Create, 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.
4 
5## Prerequisites
6 
7Requires [AI Maestro](https://github.com/23blocks-OS/ai-maestro) running locally with tmux 3.0+.
8 
9```bash
10# Install the CLI
11git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
12cd ai-maestro-plugins && ./install-agent-cli.sh
13```
14 
15## Core Commands
16 
17### Agent Lifecycle
18 
19| Command | Description |
20|---------|-------------|
21| `aimaestro-agent.sh list` | List all agents with status |
22| `aimaestro-agent.sh show <agent>` | Detailed agent information |
23| `aimaestro-agent.sh create <name> --dir <path>` | Create new agent |
24| `aimaestro-agent.sh update <agent> --task "..."` | Update task/tags |
25| `aimaestro-agent.sh delete <agent> --confirm` | Delete agent |
26| `aimaestro-agent.sh rename <old> <new>` | Rename agent |
27| `aimaestro-agent.sh hibernate <agent>` | Save state, free resources |
28| `aimaestro-agent.sh wake <agent>` | Resume hibernated agent |
29| `aimaestro-agent.sh restart <agent>` | Hibernate then wake |
30 
31### Plugin Management
32 
33| Command | Description |
34|---------|-------------|
35| `aimaestro-agent.sh plugin install <agent> <plugin>` | Install plugin |
36| `aimaestro-agent.sh plugin uninstall <agent> <plugin>` | Remove plugin |
37…