Skip to content

docs(readme): add runaway + action-authority demo GIFs above Quick Start#141

Merged
amavashev merged 1 commit into
mainfrom
seo/readme-visuals
Apr 30, 2026
Merged

docs(readme): add runaway + action-authority demo GIFs above Quick Start#141
amavashev merged 1 commit into
mainfrom
seo/readme-visuals

Conversation

@amavashev
Copy link
Copy Markdown
Collaborator

What

Adds two demo GIFs (already hosted on runcycles.io) to the top of cycles-server README, between the opening paragraph and the Quick Start section.

  • demo-runaway.gif — shows Cycles enforcing a hard budget cap on a runaway agent loop ($6 in 30s into the wall at $1)
  • demo-action-authority.gif — shows Cycles blocking an unauthorized tool call before the side effect lands

Each GIF links back to the corresponding standalone demo repo and includes alt text for accessibility.

Why

GitHub READMEs with a screenshot or demo GIF up top get more stars, longer dwell time, and stronger conversion to clones. The repo has none today; the docs site already hosts polished GIFs that match the README narrative ("hard limits on AI agent spend, risk, and tool actions before execution"). Wiring them in is a one-line insert.

Scope

  • 1 file changed: README.md
  • ~14 lines inserted before ## Quick Start
  • No content removed, no existing images touched
  • Images sourced from runcycles.io (CDN-served, stable URLs)

Continuation of the org-wide SEO/discoverability pass. Sibling work: profile README rework (runcycles/.github#33), keyword-front-loaded H1s in the 6 pinned repos.

@amavashev amavashev merged commit 45a71b9 into main Apr 30, 2026
5 checks passed
@amavashev amavashev deleted the seo/readme-visuals branch April 30, 2026 19:17
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.

1 participant