From c7d9cb16f2880fda71a608a1deec123d60b9b504 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 23 Sep 2026 19:21:05 +0000 Subject: [PATCH 1/2] fix(agent): show duration units in debugger timeout flags `--idle-timeout` wrapped `stop` in backticks, which urfave/cli reads as the flag's placeholder, so help printed `--idle-timeout stop`. Use a DURATION placeholder and give example values for it and `say --timeout`. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01JLeMSp9LH6VsBNFjm8cg6h --- cmd/lk/debugger.go | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/cmd/lk/debugger.go b/cmd/lk/debugger.go index 04cbb4f1..61e3cb91 100644 --- a/cmd/lk/debugger.go +++ b/cmd/lk/debugger.go @@ -68,7 +68,7 @@ var sessionPortFlag = &cli.IntFlag{ var sessionIdleFlag = &cli.DurationFlag{ Name: "idle-timeout", Value: defaultIdleTimeout, - Usage: "Stop the session after this long without any command (0 to keep it running until `stop`)", + Usage: "Stop the session after `DURATION` without any command, such as 30m, 2h, or 90s (0 keeps it running until stop)", } var sessionMetricsFlag = &cli.BoolFlag{ @@ -182,7 +182,7 @@ be piped on stdin: &cli.DurationFlag{ Name: "timeout", Value: defaultSayTimeout, - Usage: "Give up waiting for the agent's reply after this long", + Usage: "Give up waiting for the agent's reply after `DURATION`, such as 2m or 90s", }, &cli.BoolFlag{ Name: "logs", From c13092ee663ec1b09f4be933b256a0d47b094486 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 24 Sep 2026 04:32:34 +0000 Subject: [PATCH 2/2] chore: regenerate fish completion for the debugger flag help Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01JLeMSp9LH6VsBNFjm8cg6h --- autocomplete/fish_autocomplete | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/autocomplete/fish_autocomplete b/autocomplete/fish_autocomplete index b76e75f8..247c4c2f 100644 --- a/autocomplete/fish_autocomplete +++ b/autocomplete/fish_autocomplete @@ -81,7 +81,7 @@ complete -x -c lk -n '__fish_seen_subcommand_from agent a; and not __fish_seen_s complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from debugger dbg' -f -l help -s h -d 'show help' complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from debugger dbg; and not __fish_seen_subcommand_from start say chat-history transcript events status logs restart stop serve help h' -a 'start' -d 'Start the agent in the background and wait until it is ready' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l port -r -d 'Loopback port the session listens on (one session per port)' -complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l idle-timeout -r -d 'Stop the session after this long without any command (0 to keep it running until `stop`)' +complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l idle-timeout -r -d 'Stop the session after `DURATION` without any command, such as 30m, 2h, or 90s (0 keeps it running until stop)' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l json -s j -d 'Output as JSON' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l help -s h -d 'show help' complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command' @@ -89,7 +89,7 @@ complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subco complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l port -r -d 'Loopback port the session listens on (one session per port)' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l json -s j -d 'Output as JSON' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l metrics -d 'Show latency metrics: time to first token per reply and how long each turn took' -complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l timeout -r -d 'Give up waiting for the agent\'s reply after this long' +complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l timeout -r -d 'Give up waiting for the agent\'s reply after `DURATION`, such as 2m or 90s' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l logs -d 'Interleave agent log lines emitted during the turn' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l help -s h -d 'show help' complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command' @@ -284,7 +284,7 @@ complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subco complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg' -f -l help -s h -d 'show help' complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and not __fish_seen_subcommand_from start say chat-history transcript events status logs restart stop serve help h' -a 'start' -d 'Start the agent in the background and wait until it is ready' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l port -r -d 'Loopback port the session listens on (one session per port)' -complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l idle-timeout -r -d 'Stop the session after this long without any command (0 to keep it running until `stop`)' +complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l idle-timeout -r -d 'Stop the session after `DURATION` without any command, such as 30m, 2h, or 90s (0 keeps it running until stop)' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l json -s j -d 'Output as JSON' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start' -f -l help -s h -d 'show help' complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from start; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command' @@ -292,7 +292,7 @@ complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subco complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l port -r -d 'Loopback port the session listens on (one session per port)' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l json -s j -d 'Output as JSON' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l metrics -d 'Show latency metrics: time to first token per reply and how long each turn took' -complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l timeout -r -d 'Give up waiting for the agent\'s reply after this long' +complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l timeout -r -d 'Give up waiting for the agent\'s reply after `DURATION`, such as 2m or 90s' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l logs -d 'Interleave agent log lines emitted during the turn' complete -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say' -f -l help -s h -d 'show help' complete -x -c lk -n '__fish_seen_subcommand_from agent a; and __fish_seen_subcommand_from daemon dbg; and __fish_seen_subcommand_from say; and not __fish_seen_subcommand_from help h' -a 'help' -d 'Shows a list of commands or help for one command'