agent management
- Repo stars 27,504
- Author repo claude-code-templates
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @davila7 · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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
# 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.
Sections and files
Listed in source order.
sections -> Prerequisites → Core Commands → Agent Lifecycle → Plugin Management → Export/Import → Usage Examples
terms -> 6 skills · Create, manage, and orchestrate multiple AI agents through a unified CLI. · Requires [AI Maestro](https://github.com/23blocks-OS/ai-maestro) running locally with tmux 3.0+.
files/cmd -> aimaestro-agent.sh list · aimaestro-agent.sh show <agent> · aimaestro-agent.sh create <name> --dir <path> · aimaestro-agent.sh update <agent> --task "..." · aimaestro-agent.sh delete <agent> --confirm · aimaestro-agent.sh rename <old> <new> · aimaestro-agent.sh hibernate <agent> · aimaestro-agent.sh wake <agent>
body sha256 -> 544f51a2214a
Prerequisites
Requires AI Maestro running locally with tmux 3.0+.
Agent Lifecycle
Command · Description
aimaestro-agent.sh list· List all agents with statusaimaestro-agent.sh show <agent>· Detailed agent informationaimaestro-agent.sh create <name> --dir <path>· Create new agentaimaestro-agent.sh update <agent> --task "..."· Update task/tagsPlugin Management
Command · Description
aimaestro-agent.sh plugin install <agent> <plugin>· Install pluginaimaestro-agent.sh plugin uninstall <agent> <plugin>· Remove pluginaimaestro-agent.sh plugin list <agent>· List installed pluginsaimaestro-agent.sh plugin marketplace add <agent> <source>· Add marketplaceExport/Import
Command · Description
aimaestro-agent.sh export <agent>· Export agent configaimaestro-agent.sh import <file>· Import agent from fileAgent Statuses
Status · Meaning
online· Running in tmux sessionoffline· Registered but no active sessionhibernated· Saved state, session killed