Installation
Install globally from npm:
npm install -g getgrabkit
Supported commands after install: grabkit and getgrabkit.
Usage
- Run
grabkit. - Paste a GitHub repository URL in the input bar.
- Use arrow keys to navigate the tree explorer.
- Press Space to select files/folders.
- Press Enter to download selected files.
TUI Controls
| Key | Action |
|---|---|
| Up / Down | Move selection |
| Left / Right | Collapse or expand folder |
| Space | Select or unselect file/folder subtree |
| Enter | Toggle folder or download selected files |
| / | Filter mode |
| s | Smart Grab (dependency-aware) |
| d | Dependency insight |
| m | Choose download mode |
| p | Toggle preview panel |
| t | Switch theme |
| q | Quit |
Smart Grab
Smart Grab analyzes local JavaScript-family imports and includes dependency files automatically in your final download set.
- Detects import, require, and dynamic import for local paths.
- Ignores external packages by design.
- Reports unresolved and circular references safely.
Troubleshooting
Command not found
npm ls -g --depth=0 getgrabkit
npm config get prefix
Make sure your npm global bin directory is in PATH.
GitHub API limits
$env:GITHUB_TOKEN="your_token_here"
setx GITHUB_TOKEN "your_token_here"
Local Docs Preview
python -m http.server 4173 --directory docs
Open http://localhost:4173 to preview this docs website locally.