index.md (1337B)
1 --- 2 label: Githrun 3 icon: terminal 4 order: 700 5 --- 6 7 # Githrun 8 9 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. 10 11 ## Features 12 13 - **Remote execution** — run scripts from GitHub or Gist URLs instantly 14 - **Auto-dependency management** — creates temporary virtual environments and installs missing packages with `--auto-install` 15 - **Private repo access** — authenticate with GitHub tokens for private code and higher API rate limits 16 - **Bookmarks** — save long URLs as short aliases (`githrun run clean-db`) 17 - **Tool installation** — install remote scripts as permanent local CLI commands 18 - **Recursive downloads** — download entire folders or sub-directories from a repo 19 - **Interactive search** — search files in a repo and run results immediately 20 - **Smart caching** — caches API responses to speed up repeated searches and reduce API usage 21 22 ## Get started 23 24 - [CLI: Installation & Running Scripts](cli-usage.md) 25 - [CLI: Auth, Bookmarks & Tool Install](cli-auth-and-tools.md) 26 - [CLI: Find, Search & Download](cli-find-download.md) 27 - [Python API](python-api.md) 28 - [VS Code Extension](vscode-extension.md) 29 - [Configuration](configuration.md)