Introduction

Fresh is a CLI tool that fetches the latest documentation from any website and converts it to clean Markdown format. Perfect for offline reading, searching, and managing your documentation.

Fresh is designed for developers who need quick access to documentation—whether you're offline, working in your terminal, or want to integrate docs into your workflow.

Why Fresh?

Traditional documentation access has problems:

Internet required - Can't read docs without connection
Slow searches - Loading pages takes time
Scattered sources - No unified way to access multiple docs
No offline access - Can't work on the go

Fresh solves these by bringing documentation to your terminal:

# Search across docs instantly
fresh search "async def" python

# Read offline anywhere
fresh get python/tutorial/

# Quick access with aliases
fresh list react

Fresh automatically caches pages and supports full-text search—so your queries are fast even without internet.

Features

Feature	Benefit
Offline Mode	Download entire documentation sites
Smart Search	Full-text search across all pages
Markdown Output	Use with your favorite tools
Aliases	Quick access to favorite docs
Guides	Create personal documentation collections

Quick Example

# List all pages on a documentation site
fresh list https://docs.python.org/3/

# Fetch a page as Markdown
fresh get https://docs.python.org/3/tutorial/

# Search across documentation
fresh search "virtual environment" https://docs.python.org/3/

# Download for offline use
fresh sync https://docs.python.org/3/

Getting Started

Install Fresh and start using it in minutes:

# Using pip
pip install fresh-docs

# Or with uv
uv sync

Fresh requires Python 3.12 or higher. No API keys needed for basic usage!

Next Steps

Ready to get started? Here's where to go next:

Installation

Set up Fresh in your project

Quick Start

Learn the basics in 5 minutes

Commands

Explore all available commands

Guides

Learn advanced usage patterns

License

MIT