Managing Squads

A Squad in OpsSquad.ai represents a logical team of AI agents working together. Think of squads as teams organized by environment (like "Production" or "Staging"), function (like "DevOps" or "Security"), or any grouping that makes sense for your organization.

What is a Squad?

Squads serve several purposes:

• Organization - Group agents by environment, project, or function
• Isolation - Keep production and development agents separate
• Collaboration - Enable agents to work together as a team
• Monitoring - Track health and status at the squad level

Team-Based Architecture

OpsSquad.ai uses a flexible squad-based architecture. A squad can represent:

• An environment team (Production Squad, Staging Squad)
• A functional team (DevOps Squad, Security Squad, Database Squad)
• A project team (API Team, Frontend Team)
• A regional team (US-East Squad, EU-West Squad)

Creating a Squad

1. Navigate to the Squads page from the sidebar
2. Click the "Create Squad" button
3. Enter squad details:
   • Name: A friendly identifier (e.g., "Production SRE", "DevOps Team")
   • Environment: Production, Staging, or Development
   • Description: Optional notes about the squad's purpose
   • AI Settings: Configure shared behavior for squad agents (optional)
4. Click "Create"

The squad is now ready for agents to be added!

Squad Health

Squads have health indicators based on agent linking and node status:

Health Monitoring

The platform tracks squad health based on:

• Agent link status (linked vs unlinked)
• Node connectivity (online vs offline)
• Agent activity and responsiveness
• Command execution success rate

Squad Actions

From the Squads List

Click the actions menu (three dots) on any squad row:

Deleting a Squad

Important: You must delete or move all agents in a squad before you can delete the squad itself.

To delete a squad:

1. Navigate to the squad's detail page
2. Delete all agents in the squad (or move them to another squad)
3. Return to the squad settings
4. Click Delete Squad and confirm

Warning: Deleting a squad is irreversible. All squad configuration and history will be permanently removed.

Squad Detail View

Click on a squad name to see its detail page:

Overview Tab

• Squad health status
• Number of agents in squad
• Linked agents count
• Active agents count
• Creation date
• Last activity

Agents Tab

• List of all agents in this squad
• Agent link status and linked nodes
• Quick actions for each agent
• Create new agent button

Settings Tab

• Edit squad name and description
• Configure environment (Production/Staging/Development)
• AI behavior settings
• Delete squad

Filtering Squads

On the Squads page, you can filter by:

Best Practices

Naming Conventions

Use clear, descriptive squad names:

• Production SRE - Production site reliability team
• Staging DevOps - Staging environment operations
• Development Team Alpha - Development team squad
• Security Squad - Security-focused agents

Environment Separation

Tip: Always keep production and development squads separate. This prevents accidental commands from affecting production systems.

Squad Organization

• By Environment: Create separate squads for Prod, Staging, and Dev
• By Function: Organize by team responsibilities (DevOps, Security, Database)
• By Application: Create squads for different services or projects
• By Region: Organize by geographic location if needed

Troubleshooting

Squad Shows "Unhealthy" or "Degraded"

1. Check agent link status in the squad
2. Verify which agents are unlinked
3. Check if linked nodes are online
4. For offline nodes, SSH into the server and check node status:

   opssquad node status

5. Restart nodes if needed:

   sudo systemctl restart opssquad-node

6. Check network connectivity:

   nc -zv socket.opssquad.ai 9000

Agents Not Responding in Squad

1. Verify agents are linked to nodes
2. Check that linked nodes are online
3. Review agent logs for errors
4. Ensure nodes can communicate with socket.opssquad.ai:9000

Can't Create New Squad

• Check your subscription plan for squad limits
• Ensure you have sufficient credits
• Contact support if the issue persists

Next Steps

• Managing Agents - Create and link agents within your squads.
• First Deployment - Deploy your first node and link agents.