session-status

Get or update session status and usage metrics for real-time monitoring.

6|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Acosmi/CrabClaw --skill session-status-acosmi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-status
Source: https://github.com/Acosmi/CrabClaw/tree/main/docs/skills/tools/sessions/session-status
Command: npx skills add https://github.com/Acosmi/CrabClaw --skill session-status-acosmi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a fast, reliable way to view and manage the current session state and related usage metrics, enabling timely decisions and cost awareness.

Core Features & Use Cases

  • Get the current session status (active, idle, paused) to monitor health.
  • Set or update the session status to control flow (e.g., pause, resume) based on real-time needs.
  • Retrieve usage metrics such as tokens, elapsed time, and cost to support auditing and budgeting.

Quick Start

Run the session-status skill to fetch the current session state and latest usage metrics.

Frequently Asked Questions about session-status

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

FAQPage Schema
How do I check session status and monitor real-time token usage metrics?

You can check session status and retrieve real-time usage metrics by running a session query that returns active, idle, or paused states alongside token counts and cost data. This enables health checks and budget auditing.

Can I pause and resume active sessions to control workflow flow?

Yes, you can update the session status to pause or resume active workflows. By setting the session status to paused or active, you control processing flow based on real-time operational needs.

What session management details do I need to provide to update a session's state?

Updating session state requires providing an action, an optional sessionKey, and the target status within a defined input schema. The operation also enforces compliance controls like security_level and scope_check.

How does session cost analysis work for tracking token usage and elapsed time?

Session cost analysis works by retrieving aggregated usage metrics such as token counts, elapsed time, and total cost from the active session. This data supports accurate budgeting and operational auditing.

What's the best way to perform a health check on an active session?

The best way to perform a session health check is to fetch the current session status to determine if it is active, idle, or paused. This instantly verifies system responsiveness and operational state.

Are there access policies or compliance controls applied to session monitoring?

Yes, session monitoring enforces compliance controls including security_level, scope_check, and access policies defined in the configuration. These ensure only authorized actions retrieve or modify session state and usage data.