Repository navigation
Releases
Releases · Jaseunda/uls
v0.117.198
0.117.198 — 2026-09-30
-
Docker Context Management & Remote Daemon Support (
docker context):- Implemented standard Docker context management directly inside ULS containers (
docker context create,use,ls,inspect,rm,show). - Added support for targeting remote Docker daemons via
docker context create <name> --docker host=tcp://<ip>:2375anddocker context use <name>. - Automatically provisions upstream Docker CLI integration and routes API commands to remote daemons while retaining the zero-root unprivileged engine for local offline workloads.
- Implemented standard Docker context management directly inside ULS containers (
-
Autonomous AI Agent Operational Guide (
uls --i-am-agent):- Added dedicated
--i-am-agentmode to output raw, unstyled operational instructions and scripting guidelines directly to terminal pipelines and AI coding assistants. - Documented full workstation capabilities including userland Docker, macOS Metal GUI (
uls display), and native Finder SMB storage (uls mount).
- Added dedicated
-
Clickable Version & Release Links:
- Update notification banners and update completion notices now render clickable version links and a direct
[view changelog]link in your terminal, opening the release page directly in your browser.
- Update notification banners and update completion notices now render clickable version links and a direct
-
Clear Distro & Image Display in Pickers:
- The cross-device selection menus in
uls ssh,uls mount, anduls loginnow display the friendly distribution name alongside the container identifier (e.g.Arq (arq) on SM-F926B) instead of duplicate or ambiguous directory names.
- The cross-device selection menus in
-
Resilient Distro Deployment & Package Setup:
- Distro deployments now automatically detect and clear lingering cryptographic agent sockets from earlier aborted sessions, preventing initialization hangs during first boot.
- Package manager keyring setup now safely handles network and wireless ADB timeouts without crashing the deployment process, gracefully falling back to offline trusted key imports.
v0.117.194
0.117.194 — 2026-09-30
-
Autonomous AI Agent Operational Guide (
uls --i-am-agent):- Added dedicated
--i-am-agentmode to output raw, unstyled operational instructions and scripting guidelines directly to terminal pipelines and AI coding assistants. - Documented full workstation capabilities including userland Docker, macOS Metal GUI (
uls display), and native Finder SMB storage (uls mount).
- Added dedicated
-
Clickable Version & Release Links:
- Update notification banners and update completion notices now render clickable version links and a direct
[view changelog]link in your terminal, opening the release page directly in your browser.
- Update notification banners and update completion notices now render clickable version links and a direct
-
Clear Distro & Image Display in Pickers:
- The cross-device selection menus in
uls ssh,uls mount, anduls loginnow display the friendly distribution name alongside the container identifier (e.g.Arq (arq) on SM-F926B) instead of duplicate or ambiguous directory names.
- The cross-device selection menus in
-
Resilient Distro Deployment & Package Setup:
- Distro deployments now automatically detect and clear lingering cryptographic agent sockets from earlier aborted sessions, preventing initialization hangs during first boot.
- Package manager keyring setup now safely handles network and wireless ADB timeouts without crashing the deployment process, gracefully falling back to offline trusted key imports.
v0.116.191
0.116.191 — 2026-09-30
- Clickable Version & Release Links:
- Update notification banners and update completion notices now render clickable version links and a direct
[view changelog]link in your terminal, opening the release page directly in your browser.
- Update notification banners and update completion notices now render clickable version links and a direct
- Clear Distro & Image Display in Pickers:
- The cross-device selection menus in
uls ssh,uls mount, anduls loginnow display the friendly distribution name alongside the container identifier (e.g.Arq (arq) on SM-F926B) instead of duplicate or ambiguous directory names.
- The cross-device selection menus in
- Resilient Distro Deployment & Package Setup:
- Distro deployments now automatically detect and clear lingering cryptographic agent sockets from earlier aborted sessions, preventing initialization hangs during first boot.
- Package manager keyring setup now safely handles network and wireless ADB timeouts without crashing the deployment process, gracefully falling back to offline trusted key imports.
v0.115.187
0.115.187 — 2026-09-30
- Clear Distro & Image Display in Pickers:
- The cross-device selection menus in
uls ssh,uls mount, anduls loginnow display the friendly distribution name alongside the container identifier (e.g.Arq (arq) on SM-F926B) instead of duplicate or ambiguous directory names.
- The cross-device selection menus in
- Resilient Distro Deployment & Package Setup:
- Distro deployments now automatically detect and clear lingering cryptographic agent sockets from earlier aborted sessions, preventing initialization hangs during first boot.
- Package manager keyring setup now safely handles network and wireless ADB timeouts without crashing the deployment process, gracefully falling back to offline trusted key imports.
v0.111.184
0.111.184 — 2026-09-30
uls mount— Your Linux Home as a Drive on the Mac:- Mounts the container home on this Mac over SMB: a Finder window opens straight onto the mounted folder, and VS Code or any editor can open it by path. No installs, no dialogs, no root.
- Modern macOS no longer mounts
sftp://network drives at all — which is why earlier versions could report success while no volume ever appeared. The mount now uses macOS's native SMB stack end to end, and an SFTP server is still provisioned inside the container for command-line and editor SFTP workflows. - Mounts are verified before success is reported, failed or abandoned attempts no longer leave port forwards behind, and
uls mount --umountunmounts the real volume and cleans everything up. - File sharing runs on its own ports inside the container, so mounting never restarts or disturbs
uls sshsessions (and a running SSH session no longer blocks mounting). - Fixed the file-transfer backends refusing to start under the sandbox's hardened process self-check — SFTP used to close the moment authentication succeeded, and the SMB server never started at all. A small compatibility layer now lets them run, delivered to existing containers automatically on the next
uls mount.
uls vncDevice Picker:- With several phones attached — or one phone reachable over both Wi-Fi and USB —
uls vncnow asks which one to stream from, instead of failing with a misleading "no device connected".--serial <SERIAL>still targets a device directly. - Runtime output now follows the ULS design language end to end: banner up front,
::/✓/!/✗status symbols with 16-color on terminals, instead of bareuls-vnc:lines. - Fixed a leftover control socket (after interrupting a session) blocking every new desktop from starting.
- With several phones attached — or one phone reachable over both Wi-Fi and USB —
- VNC Desktop Streaming (
uls vnc):- Stream a full graphical desktop from your Android container straight to macOS over VNC with automatic port forwarding and TigerVNC client launching.
- Zero-configuration desktop bridge with support for
--serial <SERIAL>targeting.
v0.109.181
0.109.181 — 2026-09-30
uls mount— Your Linux Home as a Drive on the Mac:- Mounts the container home on this Mac over SMB: a Finder window opens straight onto the mounted folder, and VS Code or any editor can open it by path. No installs, no dialogs, no root.
- Modern macOS no longer mounts
sftp://network drives at all — which is why earlier versions could report success while no volume ever appeared. The mount now uses macOS's native SMB stack end to end, and an SFTP server is still provisioned inside the container for command-line and editor SFTP workflows. - Mounts are verified before success is reported, failed or abandoned attempts no longer leave port forwards behind, and
uls mount --umountunmounts the real volume and cleans everything up. - File sharing runs on its own ports inside the container, so mounting never restarts or disturbs
uls sshsessions (and a running SSH session no longer blocks mounting). - Fixed the file-transfer backends refusing to start under the sandbox's hardened process self-check — SFTP used to close the moment authentication succeeded, and the SMB server never started at all. A small compatibility layer now lets them run, delivered to existing containers automatically on the next
uls mount.
- VNC Desktop Streaming (
uls vnc):- Stream a full graphical desktop from your Android container straight to macOS over VNC with automatic port forwarding and TigerVNC client launching.
- Zero-configuration desktop bridge with support for
--serial <SERIAL>targeting.
v0.105.172
0.105.172 — 2026-09-28
- VNC Desktop Streaming (
uls vnc):- Stream a full graphical desktop from your Android container straight to macOS over VNC with automatic port forwarding and TigerVNC client launching.
- Zero-configuration desktop bridge with support for
--serial <SERIAL>targeting.
v0.105.167
0.105.167 — 2026-09-28
- Broader Linux App & Package Compatibility:
- Enhanced system communication and local service handling, ensuring background daemons and container tools run reliably across older and newer Android phones alike. (Contributed by Ethan Blanch, reviewed & merged by @Jaseunda)
- Resolved file attribute and permission permission issues during package installation and archive extraction on devices with strict security policies. (Contributed by Ethan Blanch, merged by @Jaseunda)
- Improved file status queries for older phone kernels, preventing crashes and hangs when running modern Linux distributions. (Contributed by Ethan Blanch, reviewed with @ItsPhysip)
- Hardened kernel feature detection across diverse phone architectures to ensure smooth startup on devices from Linux 4.8 up to modern Android 16. (Co-authored by Ethan Blanch & @ItsPhysip, merged by @Jaseunda)
- Community Developer Tooling:
- Added streamlined live compilation tools and container extension hooks so contributors can test enhancements directly on real devices with zero setup overhead. (Designed & implemented by @Jaseunda)
- Stabilized multi-architecture build pipelines for consistent performance across all supported device platforms. (Contributed by Ethan Blanch, reviewed by @ItsPhysip, merged by @Jaseunda)
- Changelog Audit:
- Verified and audited by
Darnes.
- Verified and audited by
v0.105.164
0.105.164 — 2026-09-28
- Broader Linux App & Package Compatibility:
- Enhanced system communication and local service handling, ensuring background daemons and container tools run reliably across older and newer Android phones alike. (Contributed by Ethan Blanch, reviewed & merged by @Jaseunda)
- Resolved file attribute and permission permission issues during package installation and archive extraction on devices with strict security policies. (Contributed by Ethan Blanch, merged by @Jaseunda)
- Improved file status queries for older phone kernels, preventing crashes and hangs when running modern Linux distributions. (Contributed by Ethan Blanch, reviewed with @ItsPhysip)
- Hardened kernel feature detection across diverse phone architectures to ensure smooth startup on devices from Linux 4.8 up to modern Android 16. (Co-authored by Ethan Blanch & @ItsPhysip, merged by @Jaseunda)
- Community Developer Tooling:
- Added streamlined live compilation tools and container extension hooks so contributors can test enhancements directly on real devices with zero setup overhead. (Designed & implemented by @Jaseunda)
- Stabilized multi-architecture build pipelines for consistent performance across all supported device platforms. (Contributed by Ethan Blanch, reviewed by @ItsPhysip, merged by @Jaseunda)
- Changelog Audit:
- Verified and audited by
Darnes.
- Verified and audited by
v0.103.159
0.103.159 — 2026-09-26
- Enhanced Contributor Developer Toolchain & Sandbox Compatibility:
uls --i-am-developernow dynamically compiles compatibility shims directly from the active working directory or--src <dir>, enabling external developers to test and verify custom shims on live hardware with zero reconfiguration.- Added native interposition support for local UNIX domain sockets and empty path operations, resolving background service authentication and package manager transaction locks across modern Android kernels.
- Expanded container extension hooks (
launcher-ext.c) allowing seamless custom pre-exec, terminal handling, and exit status mapping.