foxctl-room-agent

Manages foxctl room membership, inbox tasks, lifecycle actions, and durable chain-aware replies for participant agents.

3|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/joshka0/foxctl --skill foxctl-room-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foxctl-room-agent
Source: https://github.com/joshka0/foxctl/tree/main/configs/skills-pack/foxctl-room-agent
Command: npx skills add https://github.com/joshka0/foxctl --skill foxctl-room-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps participant agents reliably operate inside an existing foxctl room by following the room protocol for membership, inbox/task handling, durable replies, and escalation.

Core Features & Use Cases

  • Participant-side room protocol: Ensures you are properly joined and bound to the correct delivery context before executing work in a room.
  • Inbox, tasks, and lifecycle actions: Handles direct asks and supports claiming, touching, blocking, completing, and transitioning tasks with strict lifecycle guardrails.
  • Chain-aware durable communication: Routes replies through the room (not pane-local chat) and satisfies reply-required requests only when responding within the same message chain.
  • Reminders and room automation support: Works with the room loop for follow-ups, stale-reply nudges, and coordinator pulses while respecting reminder behavior.
  • Escalation and decision routing: Escalates decisions by sending reply-expected requests to the right participant in the room.

Quick Start

Start by checking the room state and your inbox for direct asks with the instruction: run foxctl room status and then foxctl room inbox for your actor.

Frequently Asked Questions about foxctl-room-agent

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

FAQPage Schema
How do I join a room and check inbox tasks for an agent participant?

To join a room and check inbox tasks, validate your participant membership and delivery_binding context, then run foxctl room status followed by foxctl room inbox for your actor to retrieve direct asks.

What is durable chain-aware messaging in agent orchestration?

Durable chain-aware messaging routes agent replies through the room protocol rather than pane-local chat, ensuring reply-expected requests are answered correctly within the same message chain.

How do I manage task lifecycle actions like claiming and completing in a room protocol?

Manage task lifecycle actions by claiming, touching, blocking, completing, and transitioning tasks through the room protocol, which applies strict lifecycle guardrails for participant agents.

Does foxctl room agent support WASI isolation for participant agents?

Foxctl room agent operates within WASI isolation to ensure secure participant-agent execution, handling membership validation, inbox delivery, and task lifecycle actions within the room runtime.

Why does my agent reply fail to satisfy a reply-expected request in the room?

Agent replies fail to satisfy reply-expected requests when sent outside the correct message chain or routed through pane-local chat instead of the durable room protocol delivery_binding.

What is the best way to escalate decisions through room automation?

Escalate decisions by sending reply-expected requests to the correct participant in the room, coordinating with room loop automation for follow-ups, stale-reply nudges, and coordinator pulses.