Core Features

Explorer

Browse remote files, buckets, and containers without leaving Clauge — the same workspace where you already run agents, queries, and SSH sessions.

Explorer connects to SFTP, FTP, S3-compatible storage (Amazon S3, MinIO, and similar services), and Azure Blob. Save each connection once, then open it whenever you need to look around.

Open Explorer

Open Explorer from the left sidebar. Your connections live in the left panel; pick one to browse its files on the right.

Until you add a connection, the sidebar shows No connections yet, and the main pane asks you to pick or add one. Supported types are listed there: SFTP · FTP · S3-compatible · Azure Blob.

As your list grows, use Search connections… to find a connection by name, or the chips (All, SFTP, FTP, S3, Azure) to show one type at a time.

Add a connection

Click + New Connection at the top of the sidebar — or + New connection in the empty state — choose a type, enter the details, and click Save connection. You can abandon the dialog anytime with Cancel or ×.

SFTP

Use SFTP when you need secure file access to a server you control. It runs over SSH and is the best default for production hosts.

Give the connection a clear Name, then choose how to sign in:

  • New connection details — enter host, port, username, and auth directly. Port defaults to 22. Auth can be a Password or SSH key. Optionally set a Working directory so you land in the right folder (for example /home/user).

  • Use existing SSH profile — reuse a profile you already saved in SSH mode, and optionally set a working directory.

If you choose an SSH profile and none exist yet, Clauge will tell you to add one in SSH mode first. Create it there, then come back to Explorer.

FTP

Use FTP for legacy servers and devices that don’t speak SFTP — a NAS box is a common example.

Enter a Name, Host, and Port (defaults to 21). Username defaults to anonymous; leave Password blank for anonymous access. Keep Passive mode on unless you have a reason to turn it off — it works better through most firewalls.

S3-compatible

Use this type for Amazon S3 or any S3-compatible object store, including MinIO and self-hosted setups.

Name the connection, pick the Service, then set Endpoint URL, Region, Bucket, Access key ID, and Secret access key. Leave Use path-style addressing off for standard AWS S3. For MinIO or self-hosted S3, point the endpoint at your service and turn path-style addressing on — most of those setups require it.

Azure Blob

Use Azure when you need to browse a container in an Azure Storage account.

Name the connection, then enter the Storage account, Container, and Authentication method. With Shared key, you’ll also enter the Account key.

Browse and manage

Select any saved connection to open its file browser. Search and filter chips stay in the sidebar so you can jump between hosts, buckets, and containers without hunting through a long list.

If something doesn’t connect

  • SFTP asks for an SSH profile — add one under SSH, then return to Explorer.
  • MinIO or self-hosted S3 fails — double-check the endpoint and enable Use path-style addressing.
  • FTP fails behind a firewall — confirm Passive mode is enabled.

What’s next

Keep going with the next topics in the docs: