Agent skill

check-context

Accurately check current context window and token usage. Use when the user asks about context usage, token consumption, or when monitoring context levels.

Stars 1,038
Forks 113

Install this agent skill to your Project

npx add-skill https://github.com/zylos-ai/zylos-core/tree/main/skills/check-context

SKILL.md

Check Context Skill

Check current context/token usage. The data source depends on the active runtime.

When to Use

  • When the user asks about context usage
  • When the user wants to know token consumption

How to Use

First, check the active runtime:

bash
node -e "try { const c=JSON.parse(require('fs').readFileSync(require('path').join(process.env.HOME,'zylos/.zylos/config.json'),'utf8')); console.log(c.runtime||'claude'); } catch { console.log('claude'); }"

If Claude runtime

Read the statusLine data file (updated after every turn):

bash
cat ~/zylos/activity-monitor/statusline.json

Report from the JSON:

  • Context usage: context_window.used_percentage% used, context_window.remaining_percentage% remaining
  • Tokens: context_window.total_input_tokens input, context_window.total_output_tokens output (window size: context_window.context_window_size)
  • Session cost: cost.total_cost_usd
  • Model: model.display_name

If Codex runtime

Read token usage from the most recently modified Codex JSONL session file:

bash
node -e "
const fs=require('fs'),path=require('path');
const base=path.join(process.env.HOME,'.codex/sessions');
let best=null,bestMtime=0;
function walk(d,depth){if(depth>3)return;try{fs.readdirSync(d).forEach(f=>{const p=path.join(d,f);try{const s=fs.statSync(p);if(s.isDirectory())walk(p,depth+1);else if(f.startsWith('rollout-')&&f.endsWith('.jsonl')&&s.mtimeMs>bestMtime){bestMtime=s.mtimeMs;best=p;}}catch{}});}catch{}}
walk(base,0);
if(!best){console.log('No session found');process.exit(0);}
const lines=fs.readFileSync(best,'utf8').split('\n').filter(Boolean);
for(let i=lines.length-1;i>=0;i--){try{const j=JSON.parse(lines[i]);if(j.type==='event_msg'&&j.payload?.type==='token_count'&&j.payload.info.last_token_usage){const u=j.payload.info.last_token_usage.input_tokens;const c=j.payload.info.model_context_window||128000;console.log('used:'+u+' ceiling:'+c+' pct:'+Math.round(u/c*100)+'%');process.exit(0);}}catch{}}
console.log('No token_count event found');
"

Report:

  • Context usage: pct% used (used / ceiling tokens)
  • Report the pct value clearly so the user knows if rotation is needed (threshold: 75%)

Expand your agent's capabilities with these related and highly-rated skills.

zylos-ai/zylos-core

web-console

Built-in web interface for communicating with Claude without external services. Use when setting up or configuring the web console channel, or troubleshooting browser-based access.

1,038 113
Explore
zylos-ai/zylos-core

component-management

Guidelines for managing zylos components via CLI and C4 channels. Use when installing, upgrading, or uninstalling components, or when user asks about available components.

1,038 113
Explore
zylos-ai/zylos-core

restart-claude

Use when the user asks to restart Claude Code, or after changing settings/hooks/keybindings.

1,038 113
Explore
zylos-ai/zylos-core

comm-bridge

C4 communication bridge — central gateway for ALL external communication (Telegram, Lark, etc.). Use when replying to users via the "reply via" path, sending proactive messages to external channels, querying recent conversations or checkpoint status (prefer c4-db.js CLI; sqlite3 OK for unsupported queries), fetching conversation history for Memory Sync, or creating checkpoints after sync. Incoming messages are queued by channel bots and delivered to Claude via a PM2 dispatcher daemon. Session-start hooks automatically provide conversation context and can trigger Memory Sync when unsummarized conversations exceed the configured threshold.

1,038 113
Explore
zylos-ai/zylos-core

new-session

Start a new session when context is high. Claude uses /clear, Codex uses /exit. Use when context is high or when a fresh session is needed.

1,038 113
Explore
zylos-ai/zylos-core

http

Caddy-based web server providing web console hosting, file sharing, and health check endpoints. Use when configuring HTTP access, setting up file sharing, or troubleshooting web connectivity.

1,038 113
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results