> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amit.is-a.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Githrun

Githrun is a command-line tool and VS Code extension that lets you execute, explore, and install Python scripts directly from GitHub and Gists — handling dependencies, private repositories, and local tool installation along the way.

## Features

* **Remote execution** — run scripts from GitHub or Gist URLs instantly
* **Auto-dependency management** — creates temporary virtual environments and installs missing packages with `--auto-install`
* **Private repo access** — authenticate with GitHub tokens for private code and higher API rate limits
* **Bookmarks** — save long URLs as short aliases (`githrun run clean-db`)
* **Tool installation** — install remote scripts as permanent local CLI commands
* **Recursive downloads** — download entire folders or sub-directories from a repo
* **Interactive search** — search files in a repo and run results immediately
* **Smart caching** — caches API responses to speed up repeated searches and reduce API usage

## Get started

* [CLI: Installation & Running Scripts](/githrun/cli-usage)
* [CLI: Auth, Bookmarks & Tool Install](/githrun/cli-auth-and-tools)
* [CLI: Find, Search & Download](/githrun/cli-find-download)
* [Python API](/githrun/python-api)
* [VS Code Extension](/githrun/vscode-extension)
* [Configuration](/githrun/configuration)

<p className="mt-16 border-t border-gray-200 pt-6 text-sm text-gray-500 dark:border-gray-800 dark:text-gray-400">
  Copyright © 2025–2026 <a href="https://github.com/notamitgamer" target="_blank" rel="noopener noreferrer">Amit Dutta</a>
</p>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.