intendant-log-search

Locate, search, and interpret Intendant session logs and sidecar artifacts.

14|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/intendant-dev/Intendant --skill intendant-log-search-intendant-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: intendant-log-search
Source: https://github.com/intendant-dev/Intendant/tree/main/skills/intendant-log-search
Command: npx skills add https://github.com/intendant-dev/Intendant --skill intendant-log-search-intendant-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Investigating what happened during an Intendant agent run requires navigating a complex log layout of session.jsonl timelines, turn files, byte spans, external-agent wrappers, and managed-context sidecars, which is slow and error-prone without a map. ## Core Features & Use Cases - Session Discovery: Find sessions by id, prefix, project root, or recency using session_meta.json and the external wrapper index. - Deep Log Search: Query session.jsonl events, transcript.jsonl, daemon.log, and turn files with jq and ripgrep recipes, including exact byte-span reads of model output and stdout/stderr. - Artifact Interpretation: Understand event taxonomy, context snapshots, file snapshot history, recordings, frames, Codex/Claude Code backend logs, and context rewind/fission sidecars. - Use Case: After an agent session fails, locate the session directory, inspect the event histogram, read the exact failing tool output span, and trace the error through daemon.log without reading the Intendant source code. ## Quick Start Ask the agent to use the intendant-log-search skill to find the most recent Intendant session for the current project and summarize what happened in it.

Frequently Asked Questions about intendant-log-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a specific Intendant session log?▼

Search session_meta.json files under $INTENDANT_HOME/logs (default ~/.intendant/logs) filtering by project_root, session id, or created_at timestamp. The skill provides jq one-liners that list sessions sorted by recency or filtered to the current project directory.

How do I search Intendant session.jsonl for errors?▼

Filter session.jsonl rows where level is warn or error using jq, and grep daemon.log for error, panic, or failed patterns. The skill also includes recipes for recursively searching all JSON string fields, matching the dashboard deep-search behavior.

How do I map a Codex or Claude Code session to Intendant wrapper logs?▼

Read session_identity rows in the wrapper session.jsonl or query ~/.intendant/external_wrapper_index.json by backend_session_id. Codex native rollout JSONL files live under codex_home/sessions and archived_sessions, matched by a session_meta row whose payload.id equals the backend id.

Why is a context_snapshot file missing from an old Intendant session row?▼

Context snapshot sidecars rotate to latest-only per (source, session id) stream, so only the newest row's file exists on disk. Historical rows keep their metadata but their files are deleted unless INTENDANT_CONTEXT_SNAPSHOT_KEEP_ALL=1 was set.

Does session.jsonl contain full command output from agent runs?▼

Not always. Native execAsAgent commands write full output to <nonce>_stdout.log and <nonce>_stderr.log side files, while the controller may only persist output tails. Use the runtime side files when output completeness matters.