cao-session-management

Manage CAO sessions for parallel code review and scheduled agent runs.

1.0k|202|Updated Jul 29, 2025
One-click install
npx skills add https://github.com/awslabs/cli-agent-orchestrator --skill cao-session-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cao-session-management
Source: https://github.com/awslabs/cli-agent-orchestrator/tree/main/skills/cao-session-management
Command: npx skills add https://github.com/awslabs/cli-agent-orchestrator --skill cao-session-management

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill unit provides a comprehensive interface for managing CAO (CLI Agent Orchestrator) sessions, enabling users to launch, monitor, and control multi-agent workflows efficiently.

Core Features & Use Cases

  • Session Management: Launch, check status, send instructions, unblock stuck terminals, or shut down sessions.
  • Multi-Agent Workflows: Coordinate multiple CLI coding agents (e.g., Claude Code, Kiro CLI) in parallel or sequentially.
  • Use Case: For a team working on a large codebase, use this Skill to simultaneously review code from multiple perspectives using different CLI tools.

Quick Start

To launch a session, use the command: cao launch --agents code_supervisor --headless --yolo --session-name my-task --working-directory '/path/to/project' "Build a hello-world Python script."

Frequently Asked Questions about cao-session-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage multi-agent workflows for parallel code review?

Multi-agent workflows for parallel code review are managed by launching CAO sessions that coordinate multiple CLI coding agents simultaneously. You can send instructions, check status, and shut down sessions to control the entire review process from one interface.

What is a CLI Agent Orchestrator session and when do I need it?

A CLI Agent Orchestrator (CAO) session is a managed environment for coordinating multiple CLI coding agents in parallel or sequentially. You need it when running cross-provider workflows or scheduled agent runs that require task delegation across different tools.

How do I launch a CAO session for cross-provider workflows?

To launch a CAO session for cross-provider workflows, run the command starting with `cao launch` followed by agent profiles, session name, working directory, and task instructions. This initiates headless agent execution for your specified coding tasks.

Do I need a CAO server and installed agent profiles to use session management?

Yes, session management requires a running CAO server and installed agent profiles to function. These prerequisites enable the skill to handle task delegation, status checking, and session shutdown for your multi-agent workflows.

What's the best way to unblock stuck terminals in a multi-agent CLI workflow?

The best way to unblock stuck terminals in a multi-agent CLI workflow is through the CAO session management interface. It provides specific controls to unblock stuck terminals alongside standard session monitoring and shutdown capabilities.

Can I coordinate multiple CLI coding agents sequentially instead of in parallel?

Yes, you can coordinate multiple CLI coding agents sequentially or in parallel using CAO session management. The skill supports both workflow patterns, allowing task delegation across different agent profiles like Claude Code or Kiro CLI.