Labels & Statuses

Labels and statuses are the backbone of XClaw's session organization system. They turn a flat session list into a manageable task board.

Statuses describe the lifecycle stage of a session: Todo, In Progress, Needs Review, Done. XClaw ships with these defaults, but you can customize them — add, remove, or rename to match your own workflow.

Labels are a more flexible classification dimension. A session can have multiple labels like "frontend," "urgent," "v2.0." Labels support auto-tagging — you can set up automation rules to automatically add labels when the Agent completes certain types of tasks.

Together, statuses and labels enable XClaw's inbox metaphor. Your session list is no longer an undifferentiated stream of conversations — it's a task system with priorities, categories, and lifecycle stages.

Labels can also serve as triggers for automation rules. For example: when a session is labeled "Needs Review," automatically notify the relevant people.

How to

Adding labels to a session is straightforward: click the label icon on the right side of the session title bar, type a label name, and you're done. Existing labels auto-complete as you type. A session can have multiple labels.

Changing session status is similar — click the status indicator next to the session title and pick a new status from the dropdown. You can also drag and drop sessions between status groups in the session list.

Want to customize status options? Open Settings > Labels & Statuses, where you can add new statuses (like "Deployed"), rename existing ones, or delete unneeded ones. Colors are customizable too.

Labels also work as session list filters — click the filter at the top of the left sidebar, select one or more labels, and the list shows only matching sessions. This becomes invaluable as your session count grows.

Advanced usage: in Settings > Automations, you can create label-based rules. For example: "When a session is labeled 'Done,' auto-archive it."