Release 0.1.8: SSH file browsing without SFTP

.github/workflows/ci.yml

@@ -11,6 +11,13 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  ssh-core-linux:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+      - name: Verify shell fallback against a Linux SSH fixture without SFTP
+        run: cargo test -p shellcanvas-core shell_files --lib --locked
+
   verify:
     runs-on: windows-latest
     steps:

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 Notable changes to ShellCanvas, newest first. Published SDK packages follow [semantic versioning](https://semver.org/), and desktop releases use the same version where practical. The project is pre-1.0, so a minor release may include breaking changes; those come with migration notes.
 
+## [0.1.8] - 2026-09-14
+
+### Added
+
+- Automatically try SSH shell file access when SFTP is unavailable. Compatible Linux hosts support paged browsing, individual-file uploads/downloads, file copy and read-only text preview without installing a remote helper.
+- Probe each transfer capability independently, preserve existing destinations during upload, and clean up canceled temporary uploads. Restricted accounts receive a clear explanation when neither SFTP nor compatible shell commands are available; terminal access remains independent.
+
+### Known limitations
+
+- Shell mode requires permitted POSIX shell commands and compatible utilities. It does not support editing, rename/delete/move, folder creation or transfers, or local drive attachment. Downloads require Linux descriptor metadata; uploads require temporary-file and no-clobber hard-link support. See [SSH hosts without SFTP](docs/filesystem-contract.md#ssh-hosts-without-sftp).
+- Manual verification on the reported restricted Linux host remains pending.
+
 ## [0.1.7] - 2026-09-14
 
 ### Added

crates/adapter-sdk/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "shellcanvas-adapter-sdk"
-version = "0.1.7"
+version = "0.1.8"
 edition = "2021"
 license = "MPL-2.0"
 description = "Versioned process protocol and concurrent server for ShellCanvas connection adapters"

crates/filesystem-sdk/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "shellcanvas-filesystem-sdk"
-version = "0.1.7"
+version = "0.1.8"
 edition = "2021"
 license = "MPL-2.0"
 description = "Optional filesystem handles and native bridge protocol for ShellCanvas"

crates/ssh-core/src/connection.rs

@@ -117,7 +117,7 @@ impl Connection {
         .await
     }
 
-    async fn connect_using(
+    pub(crate) async fn connect_using(
         options: &ConnectOptions,
         known_hosts: PathBuf,
         additional_known_hosts: Option<PathBuf>,

crates/ssh-core/src/lib.rs

@@ -13,6 +13,8 @@ pub mod probe;
 pub mod profiles;
 pub mod provider;
 pub mod settings;
+pub mod shell_files;
+pub use shell_files::ShellFiles;
 mod sftp_transport;
 pub mod terminal;
 pub mod text;