Build & Project

Project File Management

Guide to uploading assets, importing local projects, and downloading project source code

Learn how to upload assets, import existing local projects, and download project source code to your local machine in Atoms.

Uploading Files, Folders, and Images

Uploading code files, documents, or images provides essential context to your AI agent team so they can build your project accurately.

Upload Files & Folders:
- Click the + Add button at the bottom-left of the chat input box to pick files or folders (up to 100MB per file).
- Once uploaded, the asset displays as # FileName in the prompt box.
- To reference uploaded files during future chats, simply type # to pick from the auto-complete dropdown list.
Upload & Paste Images:
- Upload images via file picker or paste directly into the chat input box using Ctrl+V.
- Uploaded images display as # ImageName.

You can import an existing local codebase into Atoms for incremental development:

Package & Upload: Zip your local project code and drag it directly into the chat dialog box, or click the Global Folder icon in the upper-left corner → Add New File.
Extract to Workspace: Ask Alex to extract the archive to your active workspace.
Example prompt: @Alex, please help extract this zip file #/data/chats/chatid/workspace/upload/project.zip to workspace/project_name
Read Project Specs: Have your agents read the codebase and inspect README.md before initiating new feature requests.

Atoms offers multiple convenient ways to export your code and project files to local storage:

Directory Download:
- Click Editor on the right navigation panel.
- Right-click any directory or folder in the Files tree.
- Click Download.
Single File Download:
- Open the Editor panel.
- Select a specific file and click the download icon in the bottom-right corner.
Global Folder Download:
- Click the Folder icon in the top-left corner.
- Locate your target file in the chats directory and click Download.

Was this page helpful?