Demogorgon314

HarnessTrajectory — Development skill for Claude Code

Development community

A local viewer for agent sessions.

How to install HarnessTrajectory

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Demogorgon314/HarnessTrajectory and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What HarnessTrajectory does

A local viewer for agent sessions. It scans the transcripts that Claude Code and Codex write on this machine, folds them into a turn-aware event ledger with an interactive timing overview and a context dashboard, and follows sessions that are still running.

Alternatives in Development

Diagnose Seq Scans — Remedy high seq scans on a table 7.2k ★
00 Overview — Build-Out Prompt Index 2.2k ★
Claude Code Viewer — A full-featured web-based Claude Code client that provides complete interactive functionality for managing Cla 984 ★

README

Harness Trajectory

A local viewer for agent sessions. It scans the transcripts that **Claude Code** and **Codex** write on this machine, folds them into a turn-aware event ledger with an interactive timing overview and a context dashboard, and follows sessions that are still running.

The ledger, timeline, inspector, and toolbar are a port of the Trajectory view from [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (`ui-trajectory`, MIT), kept pixel-faithful by vendoring the primitives and theme tokens it renders with. The harness-specific plumbing was replaced with a small contract that any transcript adapter can target. The **Context** tab is a port of [dsh-context](https://github.com/bowenliang123/dsh-context) (Apache-2.0): the same cards, charts, and browser, fed by the transcript files instead of the dsh runtime.

Run it

pnpm install
pnpm dev           # server on http://127.0.0.1:5170, web UI on http://localhost:5173

Production build, served from one process:

pnpm build         # builds every package and bundles the web UI into apps/server/dist/public
pnpm start         # http://127.0.0.1:5170

Transcript roots default to `~/.claude/projects` and `~/.codex/sessions`; the harness overrides `CLAUDE_CONFIG_DIR` and `CODEX_HOME` are honoured, and `HARNESS_TRAJECTORY_CLAUDE_ROOT` / `HARNESS_TRAJECTORY_CODEX_ROOT` point at other directories. `--port` / `HARNESS_TRAJECTORY_PORT` change the port.

What you get

Session picker grouped by project, filterable by harness, searchable by title, project path, or id. Titles come from the harness (ai-title) or the first human prompt.
Trajectory ledger: turns, steps, user/assistant/tool/subtool records, token usage, durations, a record inspector (payload, result, schema, timing), fold controls, and live search.
Timing overview above the ledger: drag to focus an interval, wheel to zoom, recorded durations or equal widths.
Live follow: the server