super-pocket
super-pocket is a friendly grab-bag of developer tools in one CLI: pretty markdown rendering, one-file project codebase exports, README generation, dependency checks, XML helpers, templates, cheatsheets, and more.
Features
- Markdown Rendering
Beautiful terminal rendering of Markdown files with syntax highlighting and rich formatting
- Project Export
Convert entire projects to single Markdown files for easy sharing (e.g. for LLMs) and documentation
- README Generator
Inspect a repo and spit out a push-ready README (interactive or one-shot)
- Agent Templates
Manage and distribute AI agent configuration templates for consistent AI-assisted development (e.g. AGENTS.md)
- Cheatsheets
Quick access to development cheatsheets and reference materials
- Dependency Scanner
Spot outdated packages from inline specs, requirements.txt, or pyproject.toml
- PDF Tools
Convert markdown and text files to professional PDF documents
- Web Utilities
Generate favicons and other web assets from images
- LLM-Friendly XML
Turn
tag:<content>syntax into clean XML for prompts
Quick Start
Install super-pocket:
# With Homebrew (macOS/Linux)
brew tap dim-gggl/brew && brew install super-pocket
# Or with uv
uv add super-pocket
# or
uv pip install super-pocket
# Or with pip
pip install super-pocket
Render a markdown file:
pocket markdown render README.md
Export your project:
pocket project to-file -p . -o project.md
Why super-pocket?
super-pocket consolidates common developer tools into a single package, providing:
Consistency: Unified CLI interface across all tools
Productivity: Quick access to frequently-used utilities
Extensibility: Easy to add new tools and templates
Quality: Well-tested, documented, and maintained codebase
Table of Contents
Getting Started
- Installation
- Quick Start Guide
- Interactive mode (the easy way)
- First sanity check
- Render Markdown (pretty output)
- Export the whole project to one file
- Generate a README in minutes
- Spot outdated dependencies
- Spin up a starter project
- Templates & cheatsheets on tap
- PDF and web helpers
- LLM-friendly XML
- Common mini-workflows
- Next steps
User Guide
API Reference