Docs

/ block

Flag the current issue as blocked with a reason and notify the team.

The /block command marks the active issue as blocked. Use this when you can't proceed due to external dependencies or missing information.

Usage

agent chat 
/block "Waiting for API credentials"
agent chat 
/block --notify @teammate "Need design approval"

Options

Option Description Default
--notify Mention users in the blocking comment None
--priority Escalate priority when blocking No change

What Happens

  1. Status Update: Issue transitions to "Blocked"
  2. Blocking Comment: Reason added as comment with timestamp
  3. Session Paused: Current session is paused (not ended)
  4. Notifications: Mentioned users are notified

Blocking Comment

FlyDocs adds a structured comment:

Linear Comment 
**Blocked** - Waiting for API credentials

Session paused at 45 minutes.
Progress: 2/4 acceptance criteria complete.

@teammate Can you help with this?

Unblocking

When the blocker is resolved, use /activate to resume work. FlyDocs will restore your session context.

agent chat 
/activate ENG-145

Blocked Issue Visibility

Blocked issues appear prominently in /status output and session start summaries to ensure visibility.

Related Commands