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.