agent-management

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

AI Maestro Agent Management

AI Maestro Agent管理

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.
通过统一的CLI创建、管理和编排多个AI Agent。支持完整的Agent生命周期管理:创建、休眠、唤醒、重命名、导出/导入以及插件管理。属于AI Maestro套件的一部分。

Prerequisites

前置条件

Requires AI Maestro running locally with tmux 3.0+.
bash
undefined
需要本地运行AI Maestro且安装tmux 3.0+版本。
bash
undefined

Install the CLI

Install the CLI

git clone https://github.com/23blocks-OS/ai-maestro-plugins.git cd ai-maestro-plugins && ./install-agent-cli.sh
undefined
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git cd ai-maestro-plugins && ./install-agent-cli.sh
undefined

Core Commands

核心命令

Agent Lifecycle

Agent生命周期

CommandDescription
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
命令描述
aimaestro-agent.sh list
列出所有Agent及其状态
aimaestro-agent.sh show <agent>
查看Agent详细信息
aimaestro-agent.sh create <name> --dir <path>
创建新的Agent
aimaestro-agent.sh update <agent> --task "..."
更新任务/标签
aimaestro-agent.sh delete <agent> --confirm
删除Agent
aimaestro-agent.sh rename <old> <new>
重命名Agent
aimaestro-agent.sh hibernate <agent>
保存状态,释放资源
aimaestro-agent.sh wake <agent>
恢复休眠的Agent
aimaestro-agent.sh restart <agent>
先休眠再唤醒

Plugin Management

插件管理

CommandDescription
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
命令描述
aimaestro-agent.sh plugin install <agent> <plugin>
安装插件
aimaestro-agent.sh plugin uninstall <agent> <plugin>
卸载插件
aimaestro-agent.sh plugin list <agent>
列出已安装的插件
aimaestro-agent.sh plugin marketplace add <agent> <source>
添加插件市场

Export/Import

导出/导入

CommandDescription
aimaestro-agent.sh export <agent>
Export agent config
aimaestro-agent.sh import <file>
Import agent from file
命令描述
aimaestro-agent.sh export <agent>
导出Agent配置
aimaestro-agent.sh import <file>
从文件导入Agent

Usage Examples

使用示例

bash
undefined
bash
undefined

Create a backend API agent

Create a backend API agent

aimaestro-agent.sh create backend-api
--dir ~/projects/backend
--task "Build REST API with TypeScript"
--tags "api,typescript"
aimaestro-agent.sh create backend-api
--dir ~/projects/backend
--task "Build REST API with TypeScript"
--tags "api,typescript"

End of day -- save resources

End of day -- save resources

aimaestro-agent.sh hibernate frontend-ui aimaestro-agent.sh hibernate data-processor
aimaestro-agent.sh hibernate frontend-ui aimaestro-agent.sh hibernate data-processor

Resume next morning

Resume next morning

aimaestro-agent.sh wake frontend-ui --attach
aimaestro-agent.sh wake frontend-ui --attach

Install a plugin on an agent

Install a plugin on an agent

aimaestro-agent.sh plugin install backend-api my-plugin
aimaestro-agent.sh plugin install backend-api my-plugin

Backup before risky changes

Backup before risky changes

aimaestro-agent.sh export backend-api -o backup.json
undefined
aimaestro-agent.sh export backend-api -o backup.json
undefined

Agent Statuses

Agent状态

StatusMeaning
online
Running in tmux session
offline
Registered but no active session
hibernated
Saved state, session killed
状态含义
online
在tmux会话中运行
offline
已注册但无活跃会话
hibernated
已保存状态,会话已终止

Full AI Maestro Experience

完整的AI Maestro使用体验

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.
该功能属于AI Maestro平台,该平台提供6项功能用于AI Agent编排:消息传递、内存管理、文档处理、图谱、规划以及Agent管理。