Agent skill

Session Viewer

Render Codex, Claude Code, OpenClaw, or Pi session JSONL transcripts as a searchable, shareable single-file HTML viewer.

MITAuto-check passedFrontend & Design

Install Session Viewer

skills CLI

$ npx skills add openclaw/agent-skills --skill session-viewer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install openclaw/agent-skills session-viewer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/openclaw/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/session-viewer .claude/skills/session-viewer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "session-viewer" agent skill from https://github.com/openclaw/agent-skills/tree/main/skills/session-viewer into .claude/skills/session-viewer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-viewer", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/openclaw/agent-skills/tree/main/skills/session-viewer

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add openclaw/agent-skills --skill session-viewer -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install openclaw/agent-skills session-viewer --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/openclaw/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/session-viewer .agents/skills/session-viewer && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "session-viewer" agent skill from https://github.com/openclaw/agent-skills/tree/main/skills/session-viewer into .agents/skills/session-viewer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-viewer", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add openclaw/agent-skills --skill session-viewer -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install openclaw/agent-skills session-viewer --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/openclaw/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/session-viewer .cursor/skills/session-viewer && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "session-viewer" agent skill from https://github.com/openclaw/agent-skills/tree/main/skills/session-viewer into .cursor/skills/session-viewer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-viewer", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/openclaw/agent-skills.git --path skills/session-viewer

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add openclaw/agent-skills --skill session-viewer -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install openclaw/agent-skills session-viewer --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/openclaw/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/session-viewer .gemini/skills/session-viewer && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "session-viewer" agent skill from https://github.com/openclaw/agent-skills/tree/main/skills/session-viewer into .gemini/skills/session-viewer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-viewer", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install openclaw/agent-skills session-viewer

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add openclaw/agent-skills --skill session-viewer -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/openclaw/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/session-viewer .github/skills/session-viewer && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "session-viewer" agent skill from https://github.com/openclaw/agent-skills/tree/main/skills/session-viewer into .github/skills/session-viewer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-viewer", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add openclaw/agent-skills --skill session-viewer -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install openclaw/agent-skills session-viewer --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/openclaw/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/session-viewer .opencode/skills/session-viewer && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "session-viewer" agent skill from https://github.com/openclaw/agent-skills/tree/main/skills/session-viewer into .opencode/skills/session-viewer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-viewer", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: session-viewer
GitHub stars: 1.1k
Token cost: ~918 tokens
SKILL.md length: 317 words
Files: 16 (incl. scripts)
Skills in repo: 7
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Render Codex, Claude Code, OpenClaw, or Pi session JSONL transcripts as a searchable, shareable single-file HTML viewer.

Tasks that involve HTML artifacts
SKILL.md covers Commands, Where Sessions Live and Development
Runs TypeScript scripts from its folder; calls node and npm

What it does

Session Viewer is an agent skill from openclaw/agent-skills. Render Codex, Claude Code, OpenClaw, or Pi session JSONL transcripts as a searchable, shareable single-file HTML viewer.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 19 other files, including scripts (for example `agents/openai.yaml`, `package.json` and `scripts/core/detect.ts`).

It sits in Frontend & Design, covering HTML artifacts. The repository describes itself as: Useful skills for agents and claws. The licence is MIT.

When your agent uses it

Tasks that involve HTML artifacts

Example prompts

“/session-viewer”

Requirements

Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 7e73306. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 12 files in scripts/ (TypeScript), which the agent can run.
Shell commands in SKILL.md call:
- node
- npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Session Viewer loads about 918 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 317 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~34
When it runs · the whole SKILL.md, loaded when a task matches: ~918

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from openclaw/agent-skills at commit 7e73306, republished under its MIT licence (© openclaw). 317 words, ~918 tokens.

Download SKILL.mdSave it as .claude/skills/session-viewer/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.

name: session-viewer
description: Render Codex, Claude Code, OpenClaw, or Pi session JSONL transcripts as a searchable, shareable single-file HTML viewer.

Session Viewer

Use when asked to view, export, inspect, or share a Codex, Claude Code, OpenClaw, or Pi session transcript in a browser.

Commands

When the session path is not known and the agent-transcript skill is available, use it first to find the likely JSONL session:

bash

.agents/skills/agent-transcript/scripts/agent-transcript find \
  --query "$USER_GOAL_OR_TITLE $BRANCH_OR_URL" \
  --cwd "$PWD" \
  --since-days 14

Pick the highest-confidence file result, then render it with session-viewer.

From a repo that has this skill:

bash

node skills/session-viewer/scripts/session-viewer.ts <session.jsonl> --out /tmp/session.html --open

Useful modes:

bash

node skills/session-viewer/scripts/session-viewer.ts <session.jsonl> --out session.html
node skills/session-viewer/scripts/session-viewer.ts <session.jsonl> --raw --out session.html
node skills/session-viewer/scripts/session-viewer.ts --blank --out viewer.html --open

In a downstream repo that syncs shared skills under .agents/skills, replace skills/session-viewer with .agents/skills/session-viewer.

Defaults:

detects codex, claude, or pi-openclaw
embeds normalized session data into one HTML file
keeps tool input/output text in the DOM so browser search can find it
reads the complete session file, preserving full history in both export modes
--raw embeds the original JSONL and lets the browser parse it
--blank creates a reusable file-picker viewer

For an explicitly partial export, use --max-read-bytes N with a positive integer byte limit (for example, --max-read-bytes 8388608 for 8 MiB). Oversized files retain the head and tail, with a visible omission warning in the CLI and exported viewer. Truncated boundary records may be omitted; --raw embeds only the retained JSONL. Files at or below the limit remain complete. Short reads are retried; an unexpected end of file fails the export instead of reporting a complete read.

This opt-in read limit applies only to CLI file exports. The browser's file picker continues to load complete files.

Where Sessions Live

Codex:

bash

find "${CODEX_HOME:-$HOME/.codex}/sessions" -name 'rollout-*.jsonl' -type f | sort
ls -t "${CODEX_HOME:-$HOME/.codex}"/sessions/*/*/*/rollout-*.jsonl | head

OpenClaw/Pi:

bash

AGENT_ID="<agentId>"
SESSION_DIR="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/agents/$AGENT_ID/sessions"
ls -t "$SESSION_DIR"/*.jsonl | head
find "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/agents" -path '*/sessions/*.jsonl' -type f | sort

Use sessions.json in the same directory to map session keys to session ids.

Claude Code:

bash

find "$HOME/.claude/projects" -name '*.jsonl' -type f | sort
ls -t "$HOME/.claude/projects"/**/*.jsonl | head

Some Claude installs also keep exported JSON/JSONL under project-specific cache folders; prefer the newest JSONL with the target repo path in its parent folder.

Development

Scripts are native Node TypeScript. Keep them erasable:

ok: types, interfaces, unions, satisfies
avoid: enums, namespaces, decorators, parameter properties
no tsconfig path aliases; use relative imports

Importer ownership:

scripts/importers/codex.ts: Codex rollout JSONL
scripts/importers/claude.ts: Claude Code JSONL
scripts/importers/pi-openclaw.ts: Pi/OpenClaw session JSONL

Validate:

bash

npm ci --ignore-scripts
npm run typecheck
node --test skills/session-viewer/scripts/session-viewer.test.ts
scripts/validate-skills

Files

SKILL.md and 15 other files (scripts) in skills/session-viewer of openclaw/agent-skills.

SKILL.md
agents/openai.yaml
package.json
scripts/core/detect.ts
scripts/core/jsonl.ts
scripts/core/types.ts
scripts/html.ts
scripts/importers/claude.ts
scripts/importers/codex.ts
scripts/importers/pi-openclaw.ts
scripts/open-browser.ts
scripts/read-session.ts
scripts/session-viewer.test.ts
scripts/session-viewer.ts
scripts/styles.ts
tsconfig.json

Open the folder on GitHubat commit 7e73306

Compare with similar skills

Session Viewer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Session Viewer compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Session Viewer this skillopenclaw/agent-skills	1.1k	—	~918	Automated safety check: Pass	MIT	today
LobeHub Interactive Prototypelobehub/lobehub	83k	—	~1.6k	Automated safety check: Pass	Custom licence	today
Paperclip Pagepaperclipai/paperclip	98k	—	~1k	Automated safety check: Pass	MIT	today
Openkb Deck NeonVectifyAI/OpenKB	4.7k	1 repos	~4.3k	Automated safety check: Pass	Apache-2.0	2 mo ago
Webhome Homepage Builderwebhtv/webhtv	1.7k	—	~3.8k	Automated safety check: Pass	GPL-3.0	today
Solo Artifactssolo-agent/solo	697	—	~961	Automated safety check: Pass	MIT	24 days ago

Similar skills

LobeHub Interactive Prototype
lobehub/lobehub
Builds single-file interactive HTML prototypes rendered with the real LobeHub UI components and written as production-style React, so they can later be split into files.
83k GitHub stars~1.6k tokensUpdated today
Frontend & DesignAuto-check passed
Paperclip Page
paperclipai/paperclip
Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.
98k GitHub stars~1k tokensUpdated today
Frontend & DesignAuto-check passed
Openkb Deck Neon
VectifyAI/OpenKB
A skill your agent uses when the user asks the openkb chat to make a deck / slide presentation / PPT / slides / 演示稿 / 幻灯片 from their compiled KB content AND wants a dark, high-tech, neon / glow /…
4.7k GitHub starsUsed in 1 repo~4.3k tokens
Frontend & DesignAuto-check passed
Webhome Homepage Builder
webhtv/webhtv
Build, review, debug, reverse-engineer data sources for, and package FongMi/WebHome custom homepage single-file HTML.
1.7k GitHub stars~3.8k tokensUpdated today
Frontend & DesignAuto-check passed
Solo Artifacts
solo-agent/solo
A skill your agent uses when a Solo task or thread should become an interactive, reviewable, self-contained HTML artifact for progress/status, review/decision, or comparison/leaderboard work inside…
697 GitHub stars~961 tokensUpdated 24 days ago
Frontend & DesignAuto-check passed
Paper2html
QuZhan51496/paper2anything
Convert an academic paper PDF into a publish-ready, self-contained single-page project homepage (a self-contained index.html) — the kind of paper landing page researchers host on GitHub Pages.
468 GitHub stars~3.3k tokensUpdated 2 mo ago
Frontend & DesignAuto-check: notes

Questions about Session Viewer

What does Session Viewer do?

Render Codex, Claude Code, OpenClaw, or Pi session JSONL transcripts as a searchable, shareable single-file HTML viewer. Session Viewer is an agent skill from openclaw/agent-skills. Render Codex, Claude Code, OpenClaw, or Pi session JSONL transcripts as a searchable, shareable single-file HTML viewer.

When should I use Session Viewer?

Session Viewer fits situations like: tasks that involve HTML artifacts.

How do I install Session Viewer in Claude Code?

Run `npx skills add openclaw/agent-skills --skill session-viewer -a claude-code`. Or copy the skill folder (skills/session-viewer in openclaw/agent-skills) into .claude/skills/session-viewer in your project. Claude Code loads it when a task matches its description.

How do I install Session Viewer in Codex?

Run `npx skills add openclaw/agent-skills --skill session-viewer -a codex`. Or copy the skill folder (skills/session-viewer in openclaw/agent-skills) into .agents/skills/session-viewer in your project. Codex loads it when a task matches its description.

Can I use Session Viewer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openclaw/agent-skills --skill session-viewer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-viewer, .gemini/skills/session-viewer, .github/skills/session-viewer and .opencode/skills/session-viewer in your project.

What does Session Viewer need to run?

Going by SKILL.md and its folder, Session Viewer needs TypeScript for the scripts in its folder and the command-line tools its instructions call (node and npm). Our summary lists: Node.js.

Does Session Viewer access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Session Viewer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Session Viewer use?

Session Viewer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Session Viewer use?

About 918 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Session Viewer?

Skills that share tags, products or a category with Session Viewer: LobeHub Interactive Prototype (lobehub/lobehub, 83k stars), Paperclip Page (paperclipai/paperclip, 98k stars), Openkb Deck Neon (VectifyAI/OpenKB, 4.7k stars) and Webhome Homepage Builder (webhtv/webhtv, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Viewer?

openclaw (a GitHub organization) maintains it in openclaw/agent-skills, which has 1,102 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

Source: openclaw/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Session Viewer

Install Session Viewer

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Session Viewer

Commands

Where Sessions Live

Development

Files

Compare with similar skills

Similar skills

LobeHub Interactive Prototype

Paperclip Page

Openkb Deck Neon

Webhome Homepage Builder

Solo Artifacts

Paper2html

More from openclaw/agent-skills

Beam

Team Handoff

Behavior Validator

Crabbox Remote Test Runner

Handoff

Readme Standard

Questions about Session Viewer

Install Session Viewer

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Session Viewer

Commands

Where Sessions Live

Development

Files

Compare with similar skills

Similar skills

More from openclaw/agent-skills

Related

Questions about Session Viewer