How do I install the Session Info skill?

Run npx skillmds add terrylica/session-info in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Session Info safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Session Info?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Session Info free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Session Info?

terrylica (@terrylica) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Session Info by terrylica — Agent Skill

Name: Session Info
Rating: 4.2 (5 reviews)
Author: terrylica

File contents

Navigation: Plugin CLAUDE.md | Root CLAUDE.md

Session Info Skill

Returns the current Claude Code session UUID and registry information.

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

When to Use This Skill

Use this skill when:

Need to know the current session UUID for debugging
Want to check the session chain history
Verify the session registry is working
Find correlation between sessions and transcripts

Implementation

Run the session info script:

bun $HOME/.claude/plugins/marketplaces/cc-skills/plugins/statusline-tools/scripts/get-session-info.ts

Output Format

The script outputs structured session information:

Current Session: c1c1c149-1abe-45f3-8572-fd77aa046232
Short ID: c1c1c149
Project: ~/.claude
Registry: ~/.claude/projects/-Users-you--claude/.session-chain-cache.json
Chain Length: 3 session(s)
Last Updated: 2026-01-15T21:30:00.000Z

Note: The Managed By, Metadata (Repo, Hash, Branch, Model, Cost), and Recent Sessions sections shown in earlier versions of this doc are not yet implemented in get-session-info.ts. The script currently outputs only the 6 fields above.

Registry Location

The session registry follows Claude Code's native path encoding:

~/.claude/projects/{encoded-path}/.session-chain-cache.json

Where encoded-path replaces / with -:

/Users/username/eon/cc-skills → -Users-username-eon-cc-skills

References

Registry Format - Schema documentation

Troubleshooting

Issue	Cause	Solution
Script not found	Plugin not installed	Run `claude plugin list` to verify installation
JSONL ID undefined	No active session	Start Claude Code session first
Registry file not found	First session in project	Registry created automatically on first session
Chain length is 0	Fresh project	Normal for new projects, chain grows over time
Path encoding looks wrong	Special characters in path	Claude Code uses `-` to replace `/` in paths
Bun not found	Bun not installed	Install with `brew install oven-sh/bun/bun`
Permission denied	Registry file permissions	Check ~/.claude permissions (should be readable)

Post-Execution Reflection

After this skill completes, check before closing:

Did the command succeed? — If not, fix the instruction or error table that caused the failure.
Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

---name: session-infodescription: Get current Claude Code session UUID and registry info. TRIGGERS - current session, session uuid, session id, what session, which session.--- > **Navigation**: [Plugin CLAUDE.md](../../CLAUDE.md) | [Root CLAUDE.md](../../../../CLAUDE.md) # Session Info Skill Returns the current Claude Code session UUID and registry information. > **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues. ## When to Use This Skill Use this skill when: - Need to know the current session UUID for debugging - Want to check the session chain history - Verify the session registry is working - Find correlation between sessions and transcripts ## Implementation Run the session info script: ```bash bun $HOME/.claude/plugins/marketplaces/cc-skills/plugins/statusline-tools/scripts/get-session-info.ts ``` ## Output Format The script outputs structured session information: ``` Current Session: c1c1c149-1abe-45f3-8572-fd77aa046232 Short ID: c1c1c149 Project: ~/.claude Registry: ~/.claude/projects/-Users-you--claude/.session-chain-cache.json Chain Length: 3 session(s) Last Updated: 2026-01-15T21:30:00.000Z ``` > **Note**: The `Managed By`, `Metadata` (Repo, Hash, Branch, Model, Cost), and `Recent Sessions` sections shown in earlier versions of this doc are **not yet implemented** in `get-session-info.ts`. The script currently outputs only the 6 fields above. ## Registry Location The session registry follows Claude Code's native path encoding: ``` ~/.claude/projects/{encoded-path}/.session-chain-cache.json ``` Where `encoded-path` replaces `/` with `-`: - `/Users/username/eon/cc-skills` → `-Users-username-eon-cc-skills` ## References - [Registry Format](./references/registry-format.md) - Schema documentation --- ## Troubleshooting | Issue | Cause | Solution | | ------------------------- | -------------------------- | ------------------------------------------------ | | Script not found | Plugin not installed | Run `claude plugin list` to verify installation | | JSONL ID undefined | No active session | Start Claude Code session first | | Registry file not found | First session in project | Registry created automatically on first session | | Chain length is 0 | Fresh project | Normal for new projects, chain grows over time | | Path encoding looks wrong | Special characters in path | Claude Code uses `-` to replace `/` in paths | | Bun not found | Bun not installed | Install with `brew install oven-sh/bun/bun` | | Permission denied | Registry file permissions | Check ~/.claude permissions (should be readable) | ## Post-Execution Reflection After this skill completes, check before closing: 1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure. 2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match. 3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround. Only update if the issue is real and reproducible — not speculative.

Frequently asked questions