Skip to content

🚀 Add Interactive CLI Docs with DeepGuide#2

Closed
taowox wants to merge 1 commit intomainfrom
docs/cli-documentation-1751363860170
Closed

🚀 Add Interactive CLI Docs with DeepGuide#2
taowox wants to merge 1 commit intomainfrom
docs/cli-documentation-1751363860170

Conversation

@taowox
Copy link
Copy Markdown
Owner

@taowox taowox commented Jul 1, 2025

Hi there! 👋

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

This PR sets up DeepGuide—an open-source system for recording and validating interactive terminal demos right in your README (with optional CI validation).

What's in this PR

  • Adds a .dg/ directory with initial config—no code or commands run by this PR.
  • Prepares your repo for interactive CLI demos.
  • (Optional) Adds a GitHub Action workflow for future demo validation in CI.
  • Updates the README with instructions for adding your first demo.

How to add your first interactive demo

After merging this PR, simply run:

bunx @deepguide/dg capture

Then commit the generated .cast and .svg files—your README will be ready for rich, interactive terminal docs!

You can add as many demos as you want.

Why use DeepGuide?

📽️ Show live, copy-pasteable CLI usage with animated/interactive demos

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

🚫 No more GIFs or stale code blocks

Note: This PR only adds the infrastructure. No code was run or executed for your repo.

If you're not interested, feel free to close—thanks for your work on this CLI! 🙏

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.
@taoversepen taoversepen closed this Jul 1, 2025
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.

2 participants