# \[ANN\] aShell 3.0.0, now as two crates: ashell and ashell\_safe

**URL:** <https://forum.ada-lang.io/t/ann-ashell-3-0-0-now-as-two-crates-ashell-and-ashell-safe/4978>\
**Category:** Releases\
**Created:** [November 22, 2026, 3:31am UTC](https://forum.ada-lang.io/t/ann-ashell-3-0-0-now-as-two-crates-ashell-and-ashell-safe/4978 "2026-11-22T03:31:36Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![charlie5](https://forum.ada-lang.io/user_avatar/forum.ada-lang.io/charlie5/32/626_2.png) [@charlie5](https://forum.ada-lang.io/u/charlie5)\
**Post date:** [November 22, 2026, 3:31am UTC](https://forum.ada-lang.io/t/ann-ashell-3-0-0-now-as-two-crates-ashell-and-ashell-safe/4978/1 "2026-11-22T03:31:36Z")

</div>

[aShell](https://github.com/charlie5/aShell) is an Ada 2022 library for starting and interacting with OS programs, pipes and pipelines. It is POSIX only (via Florist), has been used on Linux, and is under the ISC license.

```ada
declare
   use Shell, Shell.Commands, Shell.Commands.Unsafe;
   Output : constant String := +Output_Of (Run ("ps -A | grep bash | wc"));
begin
   Put_Line (Output);
end;

```

## What’s new

Release 3.0.0 splits the library into two crates, both in the Alire index:

- **[ashell](https://alire.ada.dev/crates/ashell.html)** holds processes, pipes, directories and `Shell.Commands.Unsafe`, which runs commands directly from a single task.
- **[ashell\_safe](https://alire.ada.dev/crates/ashell_safe.html)** depends on `ashell` and adds `Shell.Commands.Safe`, which lets any task run commands. They are started by a separate spawn server, `ashell_spawn_server`, which this crate also builds.

Programs which only need `Unsafe` no longer build the spawn server.

## Upgrading

No Ada source needs to change.

- Programs which only use `Unsafe` need no changes at all.
- With Alire, programs which use `Safe` add the new crate: `alr with ashell_safe`.
- Without Alire, add `safe/library` to `GPR_PROJECT_PATH`, and `with "ashell_safe";` in your project file.
- The spawn server is unchanged, so one installed from 2.0.x still works.

If you are coming from 1.x, please also read the 2.0.0 notes in the [changelog](https://github.com/charlie5/aShell/blob/9bcc4d2e36ead2887a6a3909434db70df846cea0/CHANGELOG.md). That release changed how commands report failure, and fixed many hangs and lost results.

The full notes are on the [release page](https://github.com/charlie5/aShell/releases/tag/3.0.0). Feedback and bug reports are welcome on [GitHub](https://github.com/charlie5/aShell/issues).
