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.
