pretty-session

library0.1.3jsnpmunverified

Pretty Session turns noisy AI coding agent logs into clean terminal output for live streaming and saved sessions. Current stable version: 0.1.3. Release cadence: early-stage, active development. Key differentiators: supports Claude Code, Codex, and Gemini; three modes (parse, watch, live stream); parser structure easy to extend; built for CI and debugging. Ships TypeScript types.

devops

npm install pretty-session

package ↗

INSTALL

IMPORT

SIG · PRETTY-SESSION

pretty-session

devopsjavascriptv0.1.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

pretty-session CLI

✓ npx pretty-session parse claude

✗ npm run pretty-session parse claude

CLI is designed to be used globally or via npx; do not use local npm scripts.

parser functions

✓ import { parseClaude, parseCodex, parseGemini } from 'pretty-session'

✗ const { parseClaude } = require('pretty-session')

Package is ESM-only; CommonJS require() will not work.

watch functions

✓ import { watchClaude, watchCodex, watchGemini } from 'pretty-session'

✗ import { watchAll } from 'pretty-session'

watchAll does not exist; use provider-specific watch functions.

Installs the CLI globally and parses a simple piped message with the Claude parser.

npm install -g pretty-session && echo 'Hello, world!' | pts parse claude

Debug

Known issues

gotchaNode.js version requirement: >=20. Using older versions will cause installation failure or runtime errors.

fix

Update Node.js to v20 or higher (use nvm or asdf).

affects: all

gotchapnpm version requirement: >=9. Using older pnpm versions may cause resolution issues.

fix

Update pnpm to v9 or higher (npm install -g pnpm@latest).

affects: all

gotchaESM-only package: require() will not work. Use import statements or dynamic import().

fix

Use ES module syntax: import { parseClaude } from 'pretty-session'.

affects: all

gotchaPTS_TOOL_RESULT_LINES environment variable defaults to 0, meaning tool result previews are hidden. This can be confusing when debugging.

fix

Set PTS_TOOL_RESULT_LINES=10 or higher to see tool results.

affects: all

Errors

Common errors & fixes

ERR_REQUIRE_ESM: require() of ES Module

Using CommonJS require() to import an ESM-only package.

fix

Switch to import syntax or use dynamic import: import('pretty-session').

error:0308010C:digital envelope routines::unsupported

Using Node.js version below 20 with OpenSSL issues.

fix

Upgrade Node.js to v20+ or set NODE_OPTIONS=--openssl-legacy-provider (temporary).

Upgrade

Version history

0.1.3latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

packagepretty-session ↗