Skip to content

feat: whole URLs when piped, a summary of rounds, and a SKILL.md - #16

Merged
AustinMusiku merged 4 commits into
masterfrom
agent-output
Nov 7, 2026
Merged

AustinMusiku merged 4 commits into
masterfrom
agent-output

Conversation

@AustinMusiku

Copy link
Copy Markdown
Owner

This finishes making timeline easy for an agent to use. Piped output keeps every URL whole, a run of several rounds ends with a table of numbers, and a SKILL.md tells an agent when to reach for timeline and how to read it.

                 total  blocked   dns  connect    tls   send   wait  receive
 1  https://example.com
    round 1      657ms    0.5ms  77ms    181ms  228ms  0.2ms  170ms    0.3ms
    median 2–3   218ms        -     -        -      -  0.2ms  217ms    0.4ms
 2  https://nope.invalid
    round 1     failed
    rounds 2–3  failed

Whole URLs when piped

  • Why: piped output was drawn 80 columns wide, so labels lost their middle. An agent couldn't tell which path got a 404, and two paths on one host could look the same.
  • What changes: render.Options gains FullLabels, which run sets when stdout isn't a terminal. The bars keep the width they had, so only the label column grows. A terminal still shortens labels to fit.

Summary of rounds

  • When: under the chart for any --repeat above 1, with no flag. Anyone who runs several rounds wants the numbers, and an agent wouldn't know to ask for a flag. --json is unchanged.
  • What it shows: each request's first round beside the median of its later rounds, phase by phase. A redirect's hops are added into the request that led to them. Failed rounds are left out of the median, and the line ends with (1 of 4 failed). A request that failed every time reads failed.
  • Small things: - is a phase under 0.05ms, so the blocked column isn't full of 0.0ms. Each column is its own median, so the phases need not add up to the total; the README says so. In colour the header is grey and failed is red.

SKILL.md

  • skills/timeline/SKILL.md covers when to use timeline, why -n 3 or more answers "why is it slow", how to read the summary, the --json keys with a jq example, curl flags and what replaces them, a heredoc .http flow, and the exit statuses.
  • The README's new "For AI agents" section installs it with curl into ~/.claude/skills/timeline/, since release archives don't carry it and go install leaves no clone to copy from.

The README and --help describe the summary and whole URLs when piped.

Copilot AI balanced review requested due to automatic review settings November 6, 2026 13:57

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

@AustinMusiku
AustinMusiku merged commit 4e18c38 into master Nov 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants