Skip to content
Everruns Cloud is open in early access. Run agents without operating the platform.

Sync files between a local folder and a session.

CommandWhat it does
files syncBidirectional live sync between local directory and session workspace.
files pushOne-shot push local files to session workspace.
files pullOne-shot pull session workspace files to local directory.
files lsList files in session workspace.

Bidirectional live sync between local directory and session workspace.

Terminal window
everruns files sync [OPTIONS] --session <SESSION> [LOCAL_DIR]
FlagDescription
-s, --session <SESSION>Required. Session ID (e.g. ses_xxx)
<LOCAL_DIR>Local directory to sync (default: current directory)
--interval <INTERVAL>Remote poll interval in seconds.
--conflict <CONFLICT>Conflict strategy. One of last-write-wins, local-wins, remote-wins.
--exclude <EXCLUDE>Additional exclude patterns (repeatable) Repeatable.
--no-gitignoreDon’t read .gitignore.
--dry-runShow what would sync without making changes.
--deleteDelete files on one side when deleted on the other.
-v, --verboseShow every file operation.

One-shot push local files to session workspace.

Terminal window
everruns files push [OPTIONS] --session <SESSION> [LOCAL_DIR]
FlagDescription
-s, --session <SESSION>Required. Session ID (e.g. ses_xxx)
<LOCAL_DIR>Local directory to push from (default: current directory)
--deleteDelete remote files not present locally.
--dry-runShow what would be pushed.

One-shot pull session workspace files to local directory.

Terminal window
everruns files pull [OPTIONS] --session <SESSION> [LOCAL_DIR]
FlagDescription
-s, --session <SESSION>Required. Session ID (e.g. ses_xxx)
<LOCAL_DIR>Local directory to pull into (default: current directory)
--deleteDelete local files not present remotely.
--dry-runShow what would be pulled.

List files in session workspace.

Terminal window
everruns files ls [OPTIONS] --session <SESSION> [PATH]
FlagDescription
-s, --session <SESSION>Required. Session ID (e.g. ses_xxx)
<PATH>Remote path to list (default: root)
-r, --recursiveList recursively.
-l, --longShow size and dates.