File Explorer

The Explorer tab provides a file browser for the thread’s working directory. Instead of switching to an external IDE to inspect or organise files, you can do it directly inside Tarsk.

Opening the Explorer

Click the Explorer tab at the top of the thread view. The file tree appears, showing all files and folders in the thread’s directory (the .git folder is hidden at the root level).

Browsing Files

• Click a folder to expand it and view its contents.
• Click a file to open it in the editor panel for viewing or editing.
• Files and folders ignored by .gitignore are shown with a dimmed indicator, so you can see what the agent would skip.

Creating Files and Folders

1. Right-click a folder (or use the toolbar button) and choose New File or New Folder.
2. Enter the name. File names must not contain / or \.
3. The file or folder is created immediately inside the selected directory.

Renaming

1. Right-click a file or folder and choose Rename.
2. Enter the new name. Names must not contain /, \, ., or ...
3. The item is renamed on disk immediately.

Deleting

1. Right-click a file or folder and choose Delete.
2. Confirm the deletion. On the desktop app, items are moved to the system trash. On the CLI, items are permanently deleted.

Caution

Deleting is immediate and (in CLI mode) irreversible. Deleted files are not staged in git — they are removed from disk.

Editing Files

When you click a file in the Explorer, it opens in an inline editor where you can view and modify its content. Changes are saved to disk automatically. This is useful for quick edits alongside the agent’s work, such as:

• Adjusting a configuration value
• Fixing a typo the agent introduced
• Adding a comment to a file

Markdown Preview

Markdown files (.md, .mdx) open with a preview mode that renders formatted output alongside the raw source.

Media Preview

Image and video files (PNG, JPG, GIF, WebP, SVG, MP4, WebM, etc.) display inline previews. Media is loaded securely via blob URLs from the thread directory.

Mobile Layout

On narrow screens, the file tree can be toggled hidden to give more space to the editor panel. Use the tree visibility control in the Explorer toolbar.

Relationship to the AI Agent

The Explorer and the agent operate on the same filesystem. Changes you make in the Explorer are visible to the agent immediately, and vice versa. If you and the agent edit the same file simultaneously, the last write wins — so coordinate on which files you are each working on.

Tips

• Use the Explorer to quickly inspect what the agent has created or modified without leaving Tarsk.
• The Explorer is especially useful for reviewing files the agent created (images, config files, generated code) before committing.
• If you need a full-featured editor experience, use Open With to open the thread directory in your IDE instead.