Skip to content

🚀 Add Interactive CLI Docs with DeepGuide #2686

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.

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

taowox
Copy link

@taowox taowox commented Jul 8, 2025

Hi there! 👋

I noticed cli is an actively maintained CLI tool and wanted to help make your documentation even better!

This PR sets up DeepGuide, a tool for recording and validating interactive terminal demos right in your README (with optional CI validation).

What's in this PR

  • a .dg/ directory with initial config.
  • Prep your repo for capturing CLI demos.
  • Adds a GitHub Action workflow for validation in CI.
  • No code or functional changes to your repo.

How to add your first interactive demo

After merging this PR, simply run:

npx @deepguide-ai/dg doctor
npx @deepguide-ai/dg capture

Copy the generated markdown to README or other docs as you like. Then commit the changes.
Your repo will be ready for rich, interactive terminal docs!

Why use DeepGuide CLI?

📽️ Easily show live, copy-pasteable usage with animated/interactive demos

🚫 No more GIFs or stale code blocks

🟢 Keep demos up to date (self-testing with CI validation)

If you're not interested, feel free to close. Thanks for your work! 🙏

Adds DeepGuide scaffold files to enable interactive terminal demonstrations:
- Configuration setup (.dg/config.json)
- CI validation workflow
- Documentation updates
- Git ignore patterns for demo assets

No source code changes - purely additive setup for future demos.
@github-actions github-actions bot added the docs Documentation change label Jul 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation change
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant