Importing Projects

From a project's menu, "Import into this workspace" opens Android's system document picker so you can bring an existing ZIP archive or file into that project's folder.

What happens on import

• Selecting a .zip file merge-imports it: files inside the archive are added or overwritten, and files already in the workspace that aren't in the archive are left untouched.
• Selecting a non-zip file imports it as a single file into the workspace.
• If any filenames would be overwritten, Deputy Shell scans for those conflicts first and asks you to confirm before touching any existing files.

Path safety

Before extracting anything, every entry in the archive is checked: no absolute paths, no path-traversal ("..") segments, and no unreasonably long names are allowed. Imports are also capped in size — roughly 2,000 files, 100 MB total, and 25 MB per single file — to keep a malformed or oversized archive from causing problems.

If Deputy Shell closes mid-import

Imports run as a tracked, step-by-step operation. If the app is closed or crashes partway through, the next time you open Deputy Shell it automatically rolls back any partially-written files, or keeps the import if it had already finished completely — your workspace is never left half-written.

Limitations

• Only one import or export can run against a given project at a time; a second attempt shows a busy message.
• The document picker isn't restricted to .zip at the file-choosing step — pick carefully.

Back up anything important before importing over existing work.