aim:add

AIM Add

Add an agent to the current session. If no session exists, one is created automatically with this agent as the first member.

Workspace Path Format

• Local: /path/to/project
• Local with alias: /path/to/project:custom-name
• Remote (SSH): user@host:/path/to/project
• Remote with alias: user@host:/path/to/project:custom-name

Agent names are derived from the last directory component unless an alias is provided.

Instructions

1. Parse the workspace path from: $ARGUMENTS
2. Determine your own name: use the basename of your current working directory (e.g., if cwd is /home/user/projects/my-api, your name is my-api)
3. Call the aim_add MCP tool with:
   • workspace: the workspace path
   • default_agent_name: your name (from step 2) — only used if creating a new session
4. Confirm the agent was added and show the agent list
5. Remind the user how to interact:
   • @agent-name message to talk to a specific agent
   • @all message to broadcast to all agents (you respond too)
   • Available commands: /aim:add, /aim:set, /aim:status

After Adding

From this point forward in the conversation:

• When the user writes a message containing @agent-name, extract the agent name and the message, then call aim_send with the agent name and message.
• When the user writes @all, extract the message, call aim_broadcast, AND respond to the message yourself (you are a participant too).
• Messages without any @ prefix are for you — handle them normally as the DEFAULT_AGENT.
• If someone tries to @ your own name, just respond directly — do NOT call aim_send on yourself.
• Present agent responses clearly with the @agent-name: prefix so the user knows which agent responded.