Installation
grab commands
Copy-paste reference for zephex grab — what to paste, flags, and everyday recipes.
Guide: grab overview · Web Terminal
Aliases
shell
zephex grab <url>zephex get <url>zephex pull-files <url>zephex fetch-files <url>zephex ungrab # same as grab --undozephex grab --undozephex grab clean # undo aliasWhat you can paste
| Target | Result |
|---|---|
github.com/…/blob/… | Single file into the project |
github.com/…/tree/… | All files under that folder |
github.com/owner/repo | Full public repo (within size caps) |
github1s.com/… | Same as GitHub — host normalized |
raw.githubusercontent.com/… | Single file |
npm:name · npm:name@version | Package tarball → folder |
| npmjs.com / unpkg / jsDelivr package links | Parsed as npm grab |
Flags
| Flag | What it does |
|---|---|
--force -f | Overwrite files that already exist |
--out <dir> -o | Write under this directory instead of cwd |
--keep-path | Always keep full remote path segments |
--dry-run -n | List what would be written — no disk write |
--undo | Remove files from the last grab in this project |
--max-mb <n> | Raise total size cap (default ~80 MB local) |
--yes -y | Web / large grabs: skip confirm (local rarely needs this) |
--json · -q | Machine JSON · quieter progress |
Recipes
shell
# Nested config — folders kept for youzephex grab https://github.com/xai-org/grok-build/blob/main/.cargo/config.toml # Folder into a vendor pathzephex grab https://github.com/owner/repo/tree/main/sdk/typescript --out ./vendor # Preview a folder before writingzephex grab https://github.com/owner/repo/tree/main/docs --dry-run # Overwrite a previous grab of the same fileszephex grab https://github.com/owner/repo/blob/main/LICENSE --force # npm package snapshotzephex grab npm:ms@2.1.3zephex grab https://www.npmjs.com/package/chalk # Clean up the last grabzephex grab --undoWeb terminal
In the dashboard web terminal the command is the same: grab <url>. Differences:
- Files save to the browser Downloads folder (not your project disk).
- Multi-file folders become one zip with the full tree.
- Full repos use GitHub's official zip (confirm dialog for large repos).
- After a successful save, use Open in VS Code to browse the public source in the browser (github1s).
More: Web Terminal docs
Auth & rate limits
Not your Zephex API key.grab uses GitHub's network (and npm for packages). The error GitHub rate limit hit means the free unauthenticated GitHub API budget (~60/hr per IP) is empty — not that your mcp_… key expired.
shell
export GITHUB_TOKEN=ghp_… # public repos: no scopes required (~5k/hr)export GH_TOKEN=ghp_… # same idea# or: gh auth login → grab can use gh auth token automatically # Token expired? Point env at a new PAT and retryexport GITHUB_TOKEN=ghp_FRESH_TOKENzephex grab https://github.com/owner/repo/tree/main/docsSingle-file grabs prefer raw.githubusercontent.com (often works with zero tokens). Folders need the API. Full guide: Rate limits & tokens.