Sync Your Documents with Local Files

Overview

LiveFile is a powerful feature in AiAgentNexus that allows you to synchronize and pair your documents and code blocks with files on your local system.

With LiveFile, you can create a seamless two-way connection between AiAgentNexus and your local files, saving time and improving your workflow. Key benefits include:

  • Pairing documents and code blocks with local files.

  • Monitoring local file changes and updating content in AiAgentNexus.

  • Refreshing chat attachments with the latest file content.

  • Saving changes made in AiAgentNexus directly to local files.

  • Storing AI-generated code and content for easy local access.

Requirements

To use LiveFile effectively, ensure you meet the following prerequisites:

  • Supported Browsers:

    • Google Chrome (desktop)

    • Microsoft Edge (desktop)

  • Supported Operating Systems:

    • Desktop platforms only.

    • Note: Mobile devices (iOS and Android) are not supported due to browser limitations.

  • File Types Supported:

    • Designed for text-based files (e.g., .txt, .md, .js, .py).

  • Performance:

    • Supports handling dozens of files efficiently.

  • Limitations:

    • File Size: Files up to 10 MB are supported.

    • Pairing Persistence: LiveFile connections do not persist across sessions. You will need to re-pair files after reloading the page.

    • Saving Overwrites: Saving in AiAgentNexus will overwrite the entire file. Use version control for incremental changes or backups.

How to Enable LiveFile

LiveFile can be activated either automatically or manually in your AiAgentNexus workflow.

Automatic Pairing

When you:

  • Attach, drag-and-drop, or paste a file into a chat message,

LiveFile will automatically enable for that file. You can immediately monitor, refresh, and save changes with no additional setup.

Manual Pairing

For existing attachments or code blocks that:

  • Don’t have LiveFile enabled (e.g., generated by AiAgentNexus or uploaded previously),

  • Are standalone AI-generated snippets, without a linked file,

You can manually pair them with a local file:

Pairing Attachments

  1. Open the Attachment:

    • Click on the attachment in the chat to preview it.

  2. Enable Pairing:

    • Click "Pair File" (🔗).

    • If LiveFiles are already open, you can select one. Otherwise, choose a new file from your local system.

  3. Grant Permissions:

    • Allow AiAgentNexus to access the file when prompted.

Pairing Code Blocks

  1. Access Code Block Options:

    • Click on the code block, and the header with options will appear.

  2. Start Pairing:

    • Click the "Pair File" button (🔗).

    • Choose an existing LiveFile or select a new file.

  3. Confirm Pairing:

    • Grant the necessary permissions to complete the pairing process.

How to Use LiveFile

Monitoring Changes

  • Automatic Monitoring:

    • LiveFile tracks changes made to paired files outside AiAgentNexus. If changes occur, you’ll see an alert in the LiveFile bar.

    • Use "Replace with File" to manually load the latest version of the file into AiAgentNexus.

  • Refreshing Content:

    • Click "Replace with File" (🔄) to update attachments or code blocks with the most recent local changes.

Saving Edits Back to Local Files

  • Editing Attachments or Code Blocks:

    • Open the attachment or code block and click "Edit" to make changes directly within AiAgentNexus.

  • Saving Changes:

    • Click "Save to File" (💾) to write your edits back to the local file.

    • Important: This action overwrites the entire file. Ensure you want to proceed before saving.

Best Practices

  • Monitor External Changes:

    • Refresh file content in AiAgentNexus whenever a local file is updated outside the platform.

  • Version Control:

    • Use Git or similar tools to maintain a history of changes, particularly for critical files.

Troubleshooting

  • LiveFile Options Not Available:

    • Confirm that you’re using a supported desktop browser.

    • Make sure AiAgentNexus is up-to-date.

  • Permission Issues:

    • Ensure you’ve granted the necessary permissions for file access.

    • Check your browser settings to confirm that file access is enabled.

Technical Information

LiveFile leverages the File System Access API for secure file interactions. It also utilizes browser-fs-access, an open-source library by Google Chrome Labs, to extend compatibility and provide fallback support.

Key Details:

  • Security:

    • File access is strictly permission-based and requires user confirmation.

  • Performance:

    • Optimized for handling dozens of files and large workflows (tested on systems with hundreds of files).

  • Browser Compatibility:

    • Fully supported on Google Chrome and Microsoft Edge desktop versions.

PreviousFeaturesNextAPI Feature Comparison