About agent-management
A CLI skill for managing AI Maestro agents and plugins across their lifecycle. It is intended for users running AI Maestro locally and supports agent state management and configuration transfer.
Key features
- 01Create, list, update, and delete agents
- 02Hibernate, wake, and restart agents
- 03Install and manage plugins
- 04Export and import agent configurations
Use cases
- 01Create agents for separate project tasks
- 02Hibernate agents to save resources
- 03Transfer agent configurations between setups
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/agent-managementin Claude Code to confirm it loaded.
Details
From the project READMEAI 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.
Comments
Markdown supported