new-session

new-session is a skill for Claude Code, Codex from zylos-ai/zylos-core. It costs 36 tokens per session (948 once invoked), scanned A, original, MIT.

A session-control helper for starting a fresh coding-agent conversation when the current context is nearly full. It explains the different commands used by Claude and Codex and prepares a handoff summary first.

In plain words
What is it for?
Use it when context usage is high, when a fresh session is requested, or when you need a clean context without restarting the agent's settings and hooks.
Why use it?
Long sessions can leave too little context for reliable work. This helps preserve important details and checks running background tasks before switching.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions subagents; mentions Codex.

Good fit Use it when context usage is high, when a fresh session is requested, or when you need a clean context without restarting the agent's settings and hooks.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/zylos-ai/zylos-core/new-session
About the project

Zylos is open-source infrastructure that gives an AI agent persistent memory, scheduled activity, communication channels, and the ability to maintain and extend itself. Individuals and teams use it with Claude Code or Codex through Telegram, Lark, or a web console. Its catalogue add-ons define settings, instructions, and skills for operating the agent.

zylos-ai/zylos-core · 1,160 stars · on GitHub · zylos.ai

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add zylos-ai/zylos-core --skill new-session
Clone the repo
git clone --depth 1 https://github.com/zylos-ai/zylos-core

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for new-session

README.md
[![agentmods](https://agentmods.dev/badge/skills/zylos-ai/zylos-core/new-session/github.svg)](https://agentmods.dev/skills/zylos-ai/zylos-core/new-session)
Your own site
<a href="https://agentmods.dev/skills/zylos-ai/zylos-core/new-session"><img src="https://agentmods.dev/badge/skills/zylos-ai/zylos-core/new-session/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for new-session

Your own site · 80×15
<a href="https://agentmods.dev/skills/zylos-ai/zylos-core/new-session"><img src="https://agentmods.dev/badge/skills/zylos-ai/zylos-core/new-session.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 36 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 948 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00036 $0.00948
Opus 5.5 $0.00014 $0.00379
Sonnet 5.5 $0.00007 $0.00190
Haiku 4.5 $0.00004 $0.00095

Measured 2mo ago against content hash 46201b12a8f3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

new-session scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/new-session/SKILL.md · 90 lines

How it starts

The opening of the file, as written. The whole thing — 90 lines — stays where its author put it; the contents beside it link to each section on GitHub.

New Session Skill

Start a fresh session with graceful handoff. Use runtime-specific switch commands:

  • Claude: /clear
  • Codex: /exit

When to Use

  • Context usage exceeds the runtime threshold (triggered automatically by context monitoring)
  • User explicitly asks for a new session or context reset
  • When you need a clean context but don't need to reload settings/hooks (use restart-claude for that)

Pre-Switch Checklist

Before sending the session switch command, complete these steps in order:

1. Inventory running background tasks

Check for running background agents using the current runtime's available agent/task listing capability. For Claude, this is TaskList.

Runtime behavior differs here:

  • Claude: background subagents survive /clear, so do not stop them.
  • Codex: /exit terminates background tasks. Before enqueueing /exit, make sure required background work has finished.

For each running task, note:

  • Agent ID (e.g., a42c1aabc5b984e69)
  • What it's doing (brief description)
  • Output file path (so the new session can check on it)

This information goes into the handoff summary (step 2).

2. Write a session handoff summary

Write a brief message covering:

  • What was being worked on (active tasks, user requests in progress)
  • Current state (what's done, what's pending, any blockers)
  • Running background tasks (from step 1 — include agent/task IDs and any output file paths or result handles so the new session can check on them with the runtime-appropriate output mechanism)
  • What the next session should pick up (if anything)

3. Send the handoff summary

Send the full handoff summary to the internal void channel via C4:

cat <<'EOF' | node ~/zylos/.claude/skills/comm-bridge/scripts/c4-send.js "void" "session-handoff"
<handoff summary>
EOF

The void channel is record-only: the message is stored in C4 conversation history (so the new session's startup hook, c4-session-init, includes it in startup context) but is never delivered to any real channel or display surface.

Read the full file on GitHub · 90 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 90 lines · 36 tokens per session scan A 46201b12a8f3

Subscribe to this mod's changes

new-session is a skill published in the GitHub repository zylos-ai/zylos-core (1,160 stars, last pushed yesterday), licensed MIT. It adds 36 tokens to every session and 948 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

new-session compared with skills from other repositories

new-session next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
new-sessionzylos-ai/zylos-coreSkill1.2kyesterdayMITA36Claude Code, Codex
knowledge-ingestopenclaw/openclawSkill394kyesterdayMITA80Claude Code, Codex
knowledge-meeting-ingestopenclaw/openclawSkill394kyesterdayMITA44Claude Code, Codex
knowledge-claim-consolidationopenclaw/openclawSkill394kyesterdayMITA98Claude Code, Codex
knowledge-correctopenclaw/openclawSkill394kyesterdayMITA55Claude Code, Codex
knowledge-captureopenclaw/openclawSkill394kyesterdayMITA51Claude Code, Codex
knowledge-entitiesopenclaw/openclawSkill394kyesterdayMITA43Claude Code, Codex