Kitten to navigate between user prompts in Claude Code / Codex CLI

[khughitt]

Simple kitten to jump to previous / next user input when working in Claude Code or Codex CLI. It uses the prefix characters that appear at the start of user prompts (❯ and ›) to find where to jump.

kitty.conf

# navigate between claude code / codex-cli user prompts
map alt+up            kitten scroll_prompt.py prev
map alt+down          kitten scroll_prompt.py next

scroll_prompt.py

"""Navigate between user prompts in Claude Code (❯) and Codex CLI (›)."""
from kittens.tui.handler import result_handler

def main(args: list[str]) -> str:
    pass

@result_handler(no_ui=True)
def handle_result(args: list[str], answer: str, target_window_id: int, boss) -> None:
    w = boss.window_id_map.get(target_window_id)
    if w is None:
        return

    direction = args[1] if len(args) > 1 else 'prev'

    # Ensure a regex marker is set for user prompt indicators:
    #   ❯  Claude Code
    #   ›  Codex CLI
    try:
        boss.call_remote_control(w, ('create-marker', f'--match=id:{w.id}', 'regex', '1', '[❯›]'))
    except Exception:
        pass  # Marker likely already exists

    w.scroll_to_mark(prev=(direction == 'prev'), mark=1)

Thanks, Kovid, for all of your hard work, and for all of the kittens!

[kovidgoyal]

You are welcome! Just FYI you dont need a kitten for this, you can use the builtin marks feature. https://sw.kovidgoyal.net/kitty/marks/

[khughitt]

Ah Thanks!

My first stab used built-in marks support, but I couldn't find a way to set the marker and scroll to it with a single keybinding.

Using combine, however, I found a way that appears to do the trick:

map alt+up   combine : toggle_marker regex 1 [❯›] : scroll_to_mark prev 1 : toggle_marker regex 1 [❯›]
map alt+down combine : toggle_marker regex 1 [❯›] : scroll_to_mark next 1 : toggle_marker regex 1 [❯›]