inspect-codex-trajectory

inspect-codex-trajectory is a skill for Claude Code, Codex from icesixgod/codex-trajectory. It costs 78 tokens per session (758 once invoked), scanned A, original, MIT.

A viewer for the record of a local Codex task, including its messages, tool calls, failures, timing, and token use.

In plain words
What is it for?
Use it to inspect a task timeline, review an execution trace, analyze tool performance, or view a live task record.
Why use it?
It makes it easier to understand what happened during a task and investigate slow steps or errors without opening the underlying internal files.

Skill for Claude CodeCodex

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.

agentmods
npx agentmods add skills/icesixgod/codex-trajectory/inspect-codex-trajectory
Any agent
npx skills add icesixgod/codex-trajectory --skill inspect-codex-trajectory
Clone the repo
git clone --depth 1 https://github.com/icesixgod/codex-trajectory

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 inspect-codex-trajectory

README.md
[![agentmods](https://agentmods.dev/badge/skills/icesixgod/codex-trajectory/inspect-codex-trajectory.svg)](https://agentmods.dev/skills/icesixgod/codex-trajectory/inspect-codex-trajectory)
Your own site
<a href="https://agentmods.dev/skills/icesixgod/codex-trajectory/inspect-codex-trajectory"><img src="https://agentmods.dev/badge/skills/icesixgod/codex-trajectory/inspect-codex-trajectory.svg" alt="Measured on agentmods" height="20"></a>
Per session 78 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 758 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00078 $0.00758
Opus 5 $0.00039 $0.00379
Sonnet 5 $0.00016 $0.00152
Haiku 4.5 $0.00008 $0.00076

Measured 5d ago against content hash 29da5b70032d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

inspect-codex-trajectory 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 5d 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.

plugins/codex-trajectory/skills/inspect-codex-trajectory/SKILL.md · 19 lines

What it actually says

Inspect Codex Trajectory

Use the plugin's read-only MCP tools instead of opening raw files under the Codex home directory.

  1. For the active task or the most recently updated task, call show_codex_trajectory without a session ID. Keep the default detailLevel: summary; this renders the interactive trajectory UI without tool inputs or outputs.
  2. For a historical task, call list_codex_sessions, choose the exact session ID, then call show_codex_trajectory with that ID.
  3. Use get_codex_trajectory when the user wants analysis without the interactive UI. Cite turn numbers and record indexes from its structured result. If the requested evidence predates the returned page, call it again with the response's pagination.nextBeforeRecord as beforeRecord; continue only as far back as the request requires.
  4. When the user wants a live or picture-in-picture view, call show_codex_trajectory in summary mode. The user can then click Live window in the rendered viewer. Inside Codex it fills the supported host side-panel presentation with frozen whole-task Token totals, a remaining-quota badge when official windows are present, one-click and opt-in threshold stop controls, and a chronological per-record Token stream; a regular Chromium page uses native video PiP without stop controls. Stop controls require the user's explicit experimental loopback CDP opt-in. The standard Apps surface uses an app-private direct-stop tool that pauses an active Goal before turn/interrupt, never posts a follow-up message or enters the steering queue, and fails closed while CDP is unavailable. Manual Stop rearms for later turns; automatic Stop remains latched throughout the same quota cycle, including /goal continuations, and rearms only after quota recovery, a window reset, or a guard configuration change. A rejected stale turn is rebound once and transient failures retry without consuming the latch. Selecting another trajectory disables stopping. On macOS and Windows, the token-bearing View trajectory Browser shortcut additionally requires per-connection operating-system authentication of the Codex desktop peer; failures and unsupported platforms keep it unavailable without disabling direct stop. The live window does not launch a standalone app or touch composer drafts and attachments. Do not call the app-only live-update, toolbar-setting, or direct-stop helpers directly.
  5. Use detailLevel: full only after the user explicitly asks to inspect full tool input or output. Treat those values as potentially sensitive and quote no more than the task requires. Never expose session_meta.base_instructions, encrypted reasoning, credentials, or environment variables.
  6. Explain that Codex logs do not expose DeepSeek Harness step boundaries directly. The plugin starts a new approximate step when model output resumes after one or more tool results.
  7. Treat read warnings as evidence of skipped malformed records. If a paginated lineage fails validation, report that the local task history is inconsistent; do not bypass the plugin by opening inherited rollout files directly.

The user-facing trajectory tools are read-only. They read local sessions/ and, when requested, archived_sessions/ beneath CODEX_HOME or ~/.codex. The viewer alone may use its private CDP setting and direct-stop helpers after the user changes the experimental switch or activates an enabled stop control.

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. 5d ago First seen · 19 lines · 78 tokens per session scan A 29da5b70032d

Subscribe to this mod's changes

inspect-codex-trajectory is a skill published in the GitHub repository icesixgod/codex-trajectory (245 stars, last pushed today), licensed MIT. It adds 78 tokens to every session and 758 once invoked, about $0.0004 per session on Opus 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

Other skills, from other repositories

matlab-integrate-pytorch-vision

Creates MATLAB interfaces to Python image processing and computer vision models from GitHub repositories or pip-installable packages using MPyReq. Use when asked to interface MATLAB with a Python CV/image model (segmentation, depth estimation, object detection, image generation, super-resolution, etc.), given a GitHub…

matlab/matlab-agentic-toolkit · 132 tokens

pytorch-patterns

PyTorch deep learning patterns and best practices for building robust, efficient, and reproducible training pipelines, model architectures, and data loading.

affaan-m/ECC · 32 tokens

cuml-machine-learning

Use for GPU-accelerated machine learning on tabular data using NVIDIA cuML. Triggers when tasks involve classification, regression, clustering, dimensionality reduction, or model training on datasets.

langchain-ai/deepagents · 43 tokens

optimize-for-gpu

GPU-accelerates scientific Python on NVIDIA hardware and verifies that the result is correct and faster. Use for CUDA/GPU optimization; CPU-bound NumPy, SciPy, pandas, scikit-learn, NetworkX, scikit-image, vector-search, image-processing, graph, simulation, or file-I/O workloads; CuPy, cuDF, cuML, cuGraph, cuVS…

K-Dense-AI/scientific-agent-skills · 151 tokens

hf-gradio

Use Gradio applications via API. Use when the user asks for to generate a prediction from a Gradio app on Hugging Face spaces or public URL. For example, "Generate an image using black-forest-labs/FLUX.2-dev".

gradio-app/gradio · 55 tokens

pydantic-ai

Build production-ready AI agents with PydanticAI — type-safe tool use, structured outputs, dependency injection, and multi-model support.

davila7/claude-code-templates · 32 tokens