Skip to content
OneviumDocs
On this page

Preview, edit, and save local files

Open files from chat links or the project list, edit Markdown, text, and CSV, and distinguish Office previews, unsaved drafts, and disk changes.

Identify the file you are viewing#

Onevium opens local files from links in chat and from the project file list. Check the path at the top: editing a project file changes the original on disk, while an uploaded attachment may be a copy.

Use a practice project's notes.md containing a couple of ordinary notes. Choose a file that another task is not already editing.

Open the target file#

  • Click Browse all files at the top of the conversation and select notes.md.
  • You can also click a local file link in an assistant reply. References containing line numbers can locate particular content.
  • In an open file, use the segmented path at the top to navigate directories or choose a neighboring file.

Check the path and content before editing. If access is missing, a file moved, or a temporary file expired, follow the panel's guidance to select the correct file again. A matching filename alone is not enough.

Edit Markdown and save it#

  1. Open notes.md. Eligible Markdown files support editing in the preview surface; Source lets you inspect and edit the underlying text.
  2. Append “Next: review the payment callback tests.” Unsaved changes at the top means the edit is still a draft.
  3. Click Save, or use ⌘S on macOS / Ctrl+S on Windows or Linux while the file editor is focused.
  4. Wait for Saved, then reopen the file to verify. If saving fails, read the error; text visible in the editor is not proof that it reached disk.

Saving a file does not commit it to Git. Use View changes, or follow Files, terminal, and Review, to inspect the scope of the change.

What each format supports#

FileHow to use it
Markdown, plain text, and editable source filesEdit and explicitly save; Markdown can show formatted content or source
CSV / TSVPreview as a grid; to change data, edit the delimited text in Source, save, then check columns in Preview
Excel workbooksRead-only worksheet preview; CSV text editing does not imply .xlsx editing
PDF, Word, PowerPointRead the preview; use the appropriate external application to edit the original document
Images, audio, and other mediaView, zoom, or play as supported; previewing does not modify the file
Oversized, truncated, or unsupported filesThe panel may offer only preview or an external-open option; follow its actual state

For a CSV exercise, change one value in the source while preserving separators and quotes. Return to the grid and check that columns still align. A grid preview is not an Excel editor.

Inspect generated images and request another edit#

Click a generated image in chat to open its workspace. Use Focus image to inspect one result or Image canvas to compare images from the conversation.

Select the target image and use Comment for feedback at a specific point, or Mark region and Erase to indicate an area. Saved annotations appear in the composer. Review their images and instructions, then send. They prepare a new editing task rather than overwriting the original image.

Download the result, or use Source message in the more menu to return to its conversation. See Image generation, sketching, and the image canvas for the full steps. Ordinary image previews in the project file list do not provide the same generation controls.

When another task changes the file#

An assistant, terminal command, or external editor can change the same file. The panel may then report File changed on disk or a conflict.

  • Without unsaved edits, reload to see the current disk content.
  • With a draft, preserve the text you need before deciding how to merge. Do not repeatedly save over another change while a conflict is reported.
  • Reload from disk can discard the unsaved draft; read its confirmation first.

For concurrent tasks, use different files or separate working directories. Two split conversations pointing at the same directory still share its files.

Verify the saved result#

For a Git project, run this in the target project's terminal:

bash
git diff -- notes.md

Confirm that only the intended line changed. For a non-Git project, reopen the file or check it in an external editor. A successful edit does not mean the entire project passes its tests.

Troubleshooting#

What you seeWhat to do
No Save buttonCheck that the format is editable and that you changed content; read-only previews do not offer editing actions
CSV looks like source codeSwitch to Preview for a grid; use Source to edit its data
The original project does not change after savingCheck whether this is an attachment copy or a same-named file in another directory
A file conflict is reportedPreserve your draft, inspect disk changes, then merge or reload
An Office document cannot be editedUse an external application; the panel offers a read-only preview

Editing a resource in Space

A local file preview and a Space resource have different ownership. Space supports native tables and supported spreadsheet/presentation edits, saved resource versions and document discussions. Import or create the resource in Space, then check its save status and reopen it to verify the result. Editing an imported copy does not automatically overwrite the original project file; use an explicit export or supported source action when needed.

Next steps#

Use Review and the terminal to inspect file changes, or Input tools for attachments, file references, and queued messages.