Skip to content

docs: fix demo GIF script paths and add split-screen demo - #85

Merged
msampathkumar merged 1 commit into
mainfrom
docs/demo-gif-fix-and-split-screen
Oct 1, 2026
Merged

msampathkumar merged 1 commit into
mainfrom
docs/demo-gif-fix-and-split-screen

Conversation

@msampathkumar

Copy link
Copy Markdown
Member

Summary

Fixes the recorded demo GIF (it showed No such file or directory errors) and adds a new split-screen demo of an A2A server + the a2a CLI side by side.

What changed

Fix

  • docs/demo/demo.sh: cd to the repo root so the --exec example-script paths resolve regardless of the directory the recording is launched from. This is the root cause of the No such file or directory failures in the old GIF. Keeping the paths relative also keeps the agent card's Wraps command: line clean (no absolute home-dir path).
  • docs/demo/a2a-demo.gif: regenerated from the fixed demo — now shows the real completed round trip instead of the errors.

Add

  • docs/demo/demo2.sh + docs/demo/demo2.gif: a new split-screen tmux demo — the A2A server (built from a plain script, no A2A code) on the left, the a2a CLI discovering and talking to it on the right.
  • examples/01-exec-demo/README.md: embeds demo2.gif.

Refactor

  • docs/demo/run.sh: generalized with DEMO/GIF env vars (defaults unchanged — the original flow is byte-for-byte identical) plus an optional, guarded TRIM_TAIL step used by the split-screen demo.

Verification

  • No Go code touched; the Go workflow is path-filtered and does not apply.
  • Both demos were run end-to-end from an arbitrary CWD: no errors, no home-dir leak in the rendered cards.

Regenerate

# demo 1 (single screen)
docs/demo/run.sh
# demo 2 (split screen)
DEMO=docs/demo/demo2.sh GIF=docs/demo/demo2.gif COLS=150 ROWS=28 TRIM_TAIL=1 docs/demo/run.sh

Rendered GIFs

Split-screen (demo2.gif):

demo2

Single-screen, fixed (a2a-demo.gif):

a2a-demo


Draft — opening for review of the demo content and the run.sh generalization.

- demo.sh: cd to the repo root so the --exec example-script paths
  resolve regardless of the directory the recording is launched from.
  Fixes the "No such file or directory" failures shown in the recorded
  GIF, and keeps the agent card's "Wraps command:" line clean.
- a2a-demo.gif: regenerated from the fixed demo (now shows the real
  completed round trip instead of the errors).
- demo2.sh + demo2.gif: new split-screen tmux demo -- the A2A server on
  the left, the a2a CLI driving it on the right.
- run.sh: generalized with DEMO/GIF env vars (defaults unchanged) plus
  an optional TRIM_TAIL step used by the split-screen demo.
- examples/01-exec-demo/README.md: embed demo2.gif.
@msampathkumar
msampathkumar marked this pull request as ready for review October 1, 2026 16:14

@msampathkumar msampathkumar left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

LGTM

@msampathkumar
msampathkumar merged commit eaf1678 into main Oct 1, 2026
2 of 3 checks passed
@msampathkumar
msampathkumar deleted the docs/demo-gif-fix-and-split-screen branch October 1, 2026 16:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant