gb cp

Copy files to a Genbox.

Synopsis


gb cp [source] [destination] [options]

Description

Copy files from your local machine to a genbox. Useful for uploading images, configuration files, or any data you want to share with AI sessions. Supports clipboard integration for quick uploads.

Arguments

Argument	Description
`source`	Local file path. Reads from clipboard if omitted.
`destination`	Remote path. Defaults to `/home/dev/uploads/`

Options

Option	Description
`-g, --genbox <name>`	Genbox name (prompts if not provided)
`-a, --all`	Select from all genboxes
`-w, --watch`	Watch clipboard and auto-upload local image paths

Examples

Copy File to Genbox


gb cp screenshot.png


Found in clipboard: screenshot.png
Select a genbox to copy to: my-app
Ensuring directory exists: /home/dev/uploads
Copying screenshot.png to my-app...

✓ File copied successfully!

/home/dev/uploads/screenshot.png
  ↑ Copied to clipboard! Just paste in your Claude session.

Size: 245.3 KB

Copy from Clipboard


# Copy a file path to clipboard first, then:
gb cp

Automatically reads the file path from clipboard and uploads it.

Specify Destination


gb cp config.json /home/dev/project/config.json

Specify Genbox


gb cp image.png --genbox my-app

Watch Mode (Auto-Upload)


gb cp --watch


📋 Clipboard Watch Mode
Target: my-app (5.161.xxx.xxx)

Watching clipboard for local image paths...
Copy a local file path (e.g., from drag-drop) and it will be auto-uploaded.
Press Ctrl+C to stop.

⬆ Uploading: screenshot.png...
✓ Uploaded! Remote path copied to clipboard.
  /home/dev/uploads/1704200000000-screenshot.png
  Just Cmd+V to paste in your Claude session.

Supported File Types

Watch mode auto-uploads these image types:

PNG (.png)
JPEG (.jpg, .jpeg)
GIF (.gif)
WebP (.webp)
BMP (.bmp)
SVG (.svg)
ICO (.ico)
HEIC (.heic)
TIFF (.tiff)

Workflow

Take a screenshot (Cmd+Shift+4 on macOS)
The screenshot path is copied to clipboard
Run gb cp - file is uploaded and remote path copied
Paste the path in your Claude session

Watch Mode Workflow

Start watch mode: gb cp --watch
Drag-drop or copy any local image path
Automatically uploaded, remote path copied to clipboard
Paste in your Claude session
Repeat as needed

Clipboard Detection

The command detects local paths from:

macOS/Linux:

/var/folders/... (temp files)
/private/var/folders/...
/tmp/...
/Users/...
/home/...

Windows:

C:\Users\...
C:\Temp\...
C:\Windows\Temp\...

Notes

Remote path is automatically copied to clipboard after upload
Files are uploaded to /home/dev/uploads/ by default
Directory download not yet supported
Uses SCP over SSH for secure file transfer