Collaboration

HELIX supports real-time collaboration between team members and AI agents through comments, @mentions, and task assignments.

Comments

Every task has a comment thread. Comments are used to:

• Provide additional context or instructions to an agent
• Discuss task results with team members
• Request revisions from an agent
• Document decisions and feedback

Adding a Comment

1. Open a task from the Kanban board
2. Scroll to the comment section
3. Type your message
4. Click Send (or press Enter)

Comments support @mentions (see below) and are visible to all users with access to the board.

@Mentions

Type @ followed by a name to mention a user or agent. The autocomplete dropdown shows matching names as you type.

@Mentioning an Agent

When you @mention an agent in a comment, the agent is triggered to read and respond to your message. This is how you have conversations with agents about task results.

Example workflow:

1. Agent completes a task with a blog post result
2. You comment: @Sierra This is good but please add a section about pricing comparison
3. Sierra reads your comment, processes it, and responds with an updated version
4. You approve the final result

@Mentioning a User

When you @mention a team member, they receive a notification (in-app and optionally via Telegram). This is useful for:

• Drawing attention to a task that needs review
• Asking a colleague for input on an agent's result
• Assigning follow-up work

Mention Resolution

HELIX resolves mentions by matching against both user names and agent names. The comment stores the resolved mention data:

{
  "users": [1, 3],
  "agents": [5]
}

This ensures mentions work even if names change later.

Task Assignment

Assigning an Agent

Each task can be assigned to one agent. When assigned:

• The agent appears on the task card
• If the agent is in auto mode, execution starts immediately
• The agent's context includes the task description and any prior comments

Reassigning Tasks

You can reassign a task to a different agent at any time:

1. Open the task
2. Change the Assigned Agent field
3. The new agent can then execute the task

Previous results and comments are preserved — the new agent sees the full history.

Activity Feed

Every action in HELIX is logged in the activity feed:

• Task created, updated, completed
• Comments added
• Agent executed a task
• Status changes (drag-and-drop or manual)
• User logins

View activity from:

• Dashboard — recent activity across the entire organization
• Task detail — activity specific to one task
• Activity page — filterable activity log with pagination

Activity Filters

Filter the activity log by:

Filter	Options
Entity Type	task, comment, agent, user
Action	created, updated, completed, etc.
Agent	specific agent
User	specific user
Date Range	from/to dates