---
name: Agent Management
slug: agent-management
category: AI Engineering
description: Agent Management creates, manages, and orchestrates AI agents through the AI Maestro CLI, covering agent lifecycle tasks such as create, hibernate, wake, rename, export/import, and plugin management.
github: "https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/ai-maestro/agent-management"
language: Python
stars: 30236
forks: 3396
install: "npx degit https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/ai-maestro/agent-management ~/.claude/skills/agent-management"
installs_to: ~/.claude/skills/agent-management
source_path: cli-tool/components/skills/ai-maestro/agent-management/SKILL.md
collection_size: 25
category_size: 2451
collection_url: "https://dirskills.com/collections/davila7/claude-code-templates"
added: 2026-08-14T07:11:40.210Z
last_synced: 2026-08-14T07:11:40.210Z
canonical_url: "https://dirskills.com/skills/agent-management"
---

# Agent Management

Agent Management creates, manages, and orchestrates AI agents through the AI Maestro CLI, covering agent lifecycle tasks such as create, hibernate, wake, rename, export/import, and plugin management.

**Install:**

```bash
npx degit https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/ai-maestro/agent-management ~/.claude/skills/agent-management
```

## README

# 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 <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

```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.