Sync a local folder

The simplest local-to-cloud loop. Anything that lands in a local folder mirrors into the workspace. Works for screenshots, design files, downloaded PDFs, exports from another tool, model outputs, anything.

These recipes assume arg login and arg workspace switch <name> — see Overview.

One-shot push

arg upload ~/research/competitor-analysis --to /research/competitor-analysis
arg upload ~/Desktop/diagram.png --to /research/screenshots/diagram.png

arg upload auto-switches to multipart over 32 MiB and resumes on interrupt — safe to re-run.

Continuous push with a file watcher

Mirror a local folder every time anything inside it changes — pair this with a folder where Cursor, Claude Code, or any other tool drops outputs.

# macOS — brew install fswatch
fswatch -o ~/inbox | while read -r _; do
  arg upload ~/inbox --to /inbox
done

# Linux — apt install inotify-tools
inotifywait -m -r -e close_write,create,move ~/inbox |
  while read -r _; do arg upload ~/inbox --to /inbox; done

Pull a workspace folder down

The reverse direction — useful when a teammate (or an agent) wrote something in arg.ai and you want it on disk:

arg download /research/competitor-analysis --to ~/research/
arg download /reports/Q2.pdf --stdout | less

When the change should trigger something rather than just mirror, see Automations & reactions.

Getting started

Building with agents

Core concepts

Apps

Arg SDK

Integrations

Command line

Recipes & patterns

Changelog

Sync a local folder

One-shot push

Continuous push with a file watcher

Pull a workspace folder down

Next