Use Editor to view and manage the source files in your Atoms project. You can find files, preview supported formats, compare changes, add code to Chat as context, and download individual files, folders, or the full project.

This guide only covers files stored in the project workspace. Files uploaded in Chat, generated media, cloud data, published versions, and files from connected services are managed separately.

Before you start

• Use a desktop browser. The Editor experience is limited on mobile devices.
• Wait for the Agent to finish before making manual changes to the same files.
• Open the latest project version. If you are viewing an earlier version, select Restore in the version controls, confirm Restore, and wait for the restore to finish before editing.
• Editing or downloading a project may require an eligible paid plan.

Never place passwords, API keys, access tokens, or other secrets directly in source files or Chat.

Open Editor

1. Open an existing project.
2. Select Editor from the project toolbar.
3. Wait for the file tree and file viewer to load.

The file tree appears on the left. The selected file opens on the right in a code editor or preview. The tools shown for a file depend on its format and the current project state.

Find and preview files

Search by file or folder name

1. Select Search above the file tree.
2. Enter part of a file or folder name.
3. Select a matching result to open it.

Search matches file and folder names. It does not search the text inside files. If you cannot find an item, shorten the search term, clear the search, and expand the relevant folders manually.

Search the Editor file tree by file or folder name.

Preview a file

Select a file in the tree. Atoms can preview common code and text files, HTML, Markdown, DOCX and XLSX files, images, supported audio and video, PDFs, CSV files, and Jupyter notebooks. The available preview depends on the file type.

If a file or folder cannot be previewed, download it and open it in a compatible application.

Edit project code

1. Open a supported code or text file.
2. Make your changes in the editor.
3. Wait for the saving indicator to finish. Saving synchronizes your current edit session but does not apply the entire session yet.
4. Select Preview to check the result, when a preview is available.
5. Select Submit all to apply the session, or Discard all to roll back the edits in that session.

Manual edits and Agent-generated changes can affect the same files. Submit or discard your current edits before asking the Agent to change the project, and use project history before making a large change.

Preview, discard, or submit an Editor edit session.

If Editor is read-only

Editor may temporarily prevent changes while the Agent is working, a save is in progress, or you are viewing an earlier project version. It may also be read-only for an unsupported project or account without the required access.

Wait for the current operation to finish, open the latest version, and refresh the page. If you are viewing an older version, select Restore in the version controls, confirm Restore, wait for the restore to finish, and reopen the latest version. Confirm that the Read only indicator is no longer shown before editing.

Use code in Chat and compare changes

Add a whole file to Chat

Open the file, click the vertical ... and Select file when the action is available. You can also type # in Chat and choose a project file. The file is added as context for your next request.

Open the current-file actions and select Select file.

Compare a change

Select Diff when it is available to compare the original and modified versions of a file before applying the change.

Manage files and folders

Use ... next to an item in the file tree to see the actions available for that file or folder. Depending on the item and project state, you can create, upload, rename, download, or delete files and folders.

1. Locate the file or folder in the tree.
2. Select ....
3. Choose the required action and follow the on-screen prompt.

Deleting a file or folder cannot be undone. Before deleting important project files, create a safe project version or download a copy.

Some file actions are unavailable while the Agent is changing the project or while an edit session is being saved. Wait for the current operation to finish and try again.

Download code and files

Download the current file

1. Open the file in Editor.
2. Select Download from the current-file actions.
3. Open your browser's download location and verify the file.

Download a folder

1. Select ... next to the folder.
2. Select Download. Atoms packages the folder as a ZIP archive.
3. Open the archive and verify its contents.

Download the current project

1. In Editor, select Download Project below the file tree.
2. Keep the page open while Atoms prepares the archive.
3. Open the downloaded ZIP and verify the files you need.

You must be signed in. Downloading the current project source may require an eligible paid plan. The Editor download may also be unavailable in a shared, read-only project view.

Export from Share

You can also open Share and select Export. This provides another way to export the project as a ZIP. Review the downloaded archive before relying on it as a handoff or backup.

Open Share and select Export to download the project.