Skip to content

feat(tui): implement debugger controls widget and keyboard navigation #493

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
codeZe-us merged 2 commits into from
Oct 23, 2026
Merged

feat(tui): implement debugger controls widget and keyboard navigation #493

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
985a0c3
feat(tui): implement debugger controls and recorded replay navigation
Marywase Oct 21, 2026
407da9a
Merge main and integrate timeline with controls
Marywase Oct 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,21 @@ Grat is organized as a modular monorepo:

## Documentation

### Interactive replay controls

Run `grat replay <tx-hash> --interactive` in a terminal to reconstruct a replay
and browse its recorded invocations. `Tab` / `Shift+Tab` cycles panel focus;
`j` / `k` (or arrow keys) navigates the trace. `s` advances into the next
invocation, while `o` skips nested invocations to the next sibling or ancestor.
Use `q`, `Esc`, or `Ctrl+C` to quit. These controls browse the captured replay;
they do not pause or execute a live contract VM.

The footer shows the replay position and total CPU instructions / memory bytes.
Percentages use the limits supplied by the replay profile; `n/a` means the
profile did not provide a limit, not zero usage. The current replay profiler
does not populate those limits. Terminal setup happens after reconstruction,
and raw mode, cursor visibility, and the alternate screen are restored on exit.

For full technical specifications, architecture deep-dives, and API references, visit our [Live Documentation](https://grat-ddf93e61.mintlify.app/docs/introduction).

<CardGroup cols={2}>
Expand Down
Loading