index.mdx - docs -

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