skills.rest
smykla-skalski
smykla-skalskiOFFICIAL
Explore all skills by this author →
WebsiteGitHub

harness:session:join

Join multi-agent sessions and manage agent roles and tasks via the harness CLI.

Updated Mar 14, 2026
Search Tags:#cli#multi-agent#session#task-management#agent-coordination#harness#observe
One-click install
npx skills add https://github.com/smykla-skalski/harness --skill harness-session-join
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness:session:join
Source: https://github.com/smykla-skalski/harness/tree/main/.agents/skills/harness-session-join
Command: npx skills add https://github.com/smykla-skalski/harness --skill harness-session-join

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Join and participate in coordinated multi-agent sessions without guessing session state or manipulating orchestration files directly, ensuring consistent task assignment, progress reporting, and role-based behavior across agents.

Core Features & Use Cases

  • Interactive session picker that lists active sessions, confirms selection, and orders by most recent creation.
  • Role-aware join semantics for worker, observer, reviewer, and improver with explicit workflows for claiming tasks, checkpointing progress, completing work, triage, and reviews.
  • Observation and triage tools for scanning session activity, creating tasks from findings, and initiating leader transfer when required.
  • Clear operational rules to always use harness session commands, pass --actor for mutating operations, and avoid direct file edits to orchestration state.

Quick Start

Join an active session as a worker by running harness session join <session-id> --role worker to obtain your agent ID, then list and claim tasks assigned to your agent.

Frequently Asked Questions about harness:session:join

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

FAQPage Schema
How do I join a multi-agent session and claim tasks?▼

To join multi-agent sessions, use the harness session join command with a session ID and role flag to obtain an agent ID, then list and claim tasks assigned to your agent for collaborative orchestration.

What roles can I assign to an agent when joining collaborative testing workflows?▼

Multi-agent sessions support role-aware join semantics for worker, observer, reviewer, and improver, each with explicit workflows for claiming tasks, checkpointing progress, triage, and reviews.

Can I use different agents like Claude, Codex, and Copilot for task coordination?▼

Yes, multi-agent session coordination supports agents including Claude, Codex, Gemini, Copilot, and OpenCode to coordinate tasks, observe runs, triage findings, and perform review or improvement work.

Do I need to pass specific flags for mutating operations in harness session commands?▼

Yes, you must always pass the --actor flag for mutating operations when using harness session commands to ensure consistent task assignment and progress reporting across agents.

What is the best way to manage task lifecycle and progress reporting across multiple agents?▼

Use harness session commands to manage the task lifecycle, which includes listing, joining, claiming, checkpointing, updating, and signaling tasks to ensure consistent progress reporting without direct file edits.

Why should I avoid direct file edits to orchestration state during agent coordination?▼

Direct file edits to orchestration state bypass consistent task assignment and role-based behavior, so you must use harness session commands to ensure reliable multi-agent coordination and progress tracking.

Related Skills

Explore More Software Engineering Skills→
smykla-skalskismykla-skalski

session:start

Coordinate multi-agent orchestration sessions by delegating tasks to worker agents.

Official
Advanced
speakeasy-apispeakeasy-api
19

granary-execute-task

Execute Granary sub-agent tasks by building context and reporting progress.

Official
Advanced
christian-deleonchristian-deleon

handoff

Capture and summarize the current problem and findings for transfer to another session.

Community
Basic
YeaChan05YeaChan05

team

Coordinate OMX agents in a tmux-based shared task environment.

Community
Advanced