https://github.com/orbitalshell/orbital-shell
Orbital Shell is a command shell based inspired by bash and POSIX recommendations, coded in C# NET 5.0
https://github.com/orbitalshell/orbital-shell
ansi bash cli command-line-interface command-line-parser command-line-tool command-line-tools csharp engine history interactive linux netcore31 netcore5 netstandard21 orbital posix posix-recommendations shell streams
Last synced: 5 months ago
JSON representation
Orbital Shell is a command shell based inspired by bash and POSIX recommendations, coded in C# NET 5.0
- Host: GitHub
- URL: https://github.com/orbitalshell/orbital-shell
- Owner: OrbitalShell
- License: mit
- Created: 2021-02-13T14:37:52.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-10-09T22:35:46.000Z (about 4 years ago)
- Last Synced: 2025-06-16T10:58:25.612Z (5 months ago)
- Topics: ansi, bash, cli, command-line-interface, command-line-parser, command-line-tool, command-line-tools, csharp, engine, history, interactive, linux, netcore31, netcore5, netstandard21, orbital, posix, posix-recommendations, shell, streams
- Language: C#
- Homepage: https://orbitalshell.github.io/Orbital-Shell/
- Size: 16.1 MB
- Stars: 21
- Watchers: 1
- Forks: 5
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
## Orbital Shell
Orbital Shell is a multi-platform (**windows, linux, macos, arm**) command shell (according to .Net Core supported platforms and APIs compatibilities), inspired by bash and **POSIX** recommendations.
It provides any usual bash shell feature (even if modernized) and 'user friendly' syntaxes allowing to access (get/set/call) C# objects.
Developed using **C# 8 .NET 5.0 - compatible with modules and libraries targeting .NET Core 3.1 and .NET Standard 2.1**
[](license)
**NuGet packages**
package ID
type
NuGet verion ID
libraries
OrbitalShell-ConsoleApp
OrbitalShell-Kernel
OrbitalShell-Kernel-Commands
net5.0 classlib
net5.0 classlib
net5.0 classlib
[](https://www.nuget.org/packages/OrbitalShell-ConsoleApp) 
[](https://www.nuget.org/packages/OrbitalShell-Kernel) 
[](https://www.nuget.org/packages/OrbitalShell-Kernel-Commands) 
modules
OrbitalShell-PromptGitInfo
OrbitalShell-DoomFireAlgo
shell module (net5.0)
shell module (net5.0)
[](https://www.nuget.org/packages/OrbitalShell-Module-PromptGitInfo) 
[](https://www.nuget.org/packages/OrbitalShell-Module-DoomFireAlgo) 
binaries
OrbitalShell
OrbitalShell-win-x64
OrbitalShell-linux-musl-x64
OrbitalShell-linux-x64
OrbitalShell-linux-arm
OrbitalShell-linux-arm64
OrbitalShell-osx-x64
CLI any dotnet platform*
CLI WIN x86
CLI linux MUSL x64
CLI linux x64
CLI linux ARM
CLI linux ARM x64
CLI OSX x64
[](https://www.nuget.org/packages/OrbitalShell) 
[](https://www.nuget.org/packages/OrbitalShell-win-x64) 
[](https://www.nuget.org/packages/OrbitalShell-linux-musl-x64) 
[](https://www.nuget.org/packages/OrbitalShell-linux-x64) 
[](https://www.nuget.org/packages/OrbitalShell-linux-arm) 
[](https://www.nuget.org/packages/OrbitalShell-linux-arm64) 
[](https://www.nuget.org/packages/OrbitalShell-osx-x64) 
**Docker images**
image ID
description
link
orbitalshell/orbital-shell
Linux Ubuntu amd64
https://hub.docker.com/r/orbitalshell/orbital-shell
## About the project
This shell integrates the most usefull shell commands, and is intented to be extended by coding new commands or downloading new commands modules within a repository of modules. Of course it can be entirely customized by using the features integrated to the shell (scripts, functions, commands, aliases, settings, parametrization,...). Having a strong ANSI/VT-100-220-300-500 support, it provides structured and colorized display of data and information (support of ASCII, Unicode and 24 bits colors).
Find any information and documentation about this project on the project's Web Site @ [Orbital SHell Git-Pages](https://orbitalshell.github.io/OrbitalShell/)
Developers and users manuals are available in the project web site @ [Orbital SHell Git-Pages (documentation)](https://orbitalshell.github.io/OrbitalShell/documentation)
## Contribute !
😄 We are looking for **collaborators** 👯 to help for evolving this tool ! If you **like** the **command line**, the **bash** syntax, programming **cli tools**, **parsers**, **data streams**, ANSI, C# 8, batch, and so on... you may like to develop orbital shell! Any idea, suggest, code, feedback is welcomed ! You can directly **FORK** the project @ [https://github.com/OrbitalShell/Orbital-Shell.git](https://github.com/OrbitalShell/Orbital-Shell.git) and start developing to prepare your first pull request, it will be well received. You can also peek **an issue** and start working on. Join the **orbital shell team** and get advantages of the team tools on github. We can contact 💬 by mail, skype and so on...
You can directly **FORK** the project @ [https://github.com/OrbitalShell/Orbital-Shell.git](https://github.com/OrbitalShell/Orbital-Shell.git) and start developing to prepare your first pull request, it will be well received. You can also peek **an issue** and start working on.
Join the **orbital shell team** and get advantages of the team tools on github. We can contact 💬 by mail, skype and so on...
- read the [contribution guide lines](https://github.com/OrbitalShell/Orbital-Shell/blob/master/CONTRIBUTING.md) and the [code of conduct of the project](https://github.com/OrbitalShell/Orbital-Shell/blob/master/CODE_OF_CONDUCT.md)
- read the project README @ [https://github.com/OrbitalShell/Orbital-Shell/blob/master/README.md](https://github.com/OrbitalShell/Orbital-Shell/blob/master/README.md)
- visit the project's web site @ [https://orbitalshell.github.io/Orbital-Shell/](https://orbitalshell.github.io/OrbitalShell/)
- visit the project repository @ [https://github.com/OrbitalShell/Orbital-Shell/](https://github.com/OrbitalShell/Orbital-Shell/)
**Join the project**:
## :fast_forward: :fast_forward: Join the project. You can send a mail to the project team @ [mailto://orbital-shell@outlook.fr](mailto://orbital-shell@outlook.fr) or to the maintener [me](mailto://franck.gaspoz@gmail.com)
- Curious / beginner / intermediate / expert are all welcomed!
- A simple **hello** from you part and you will be welcomed and invited to join the project 👍 !
- A simple **star** on the project main repo and you will also be invited 👋 !
## :fast_forward: :fast_forward: This project is a collaborative work, any one can participate and do anything he wishes 😎 !
There are a various subjects that can be treated:
- .NET 5.0 (C# 8) programming
- develop command line parser
- develop shell commands (find,ls,grep,sed,..: add/improve any command you want!)
- develop shell scripts (.orbsh/.sh)
- Technical documentation
- Automated Tests
- Code review / validation of pull requests
- Design any new feature
- CI/CD (powered by GitHub workflows)
- build binaries / distribs / .nupkg / setups / ...
- Web site development (design, content update, ...)
- Internationalization
- Translates
**The project team like to meet people and wish to share pleasure of programming and technology enthusiasm, with fun and good spirit**
## Features
*a view of the shell running in Windows Terminal*
- Is a '**bash** style' POSIX command shell
- The **modules** that are integrated into the shell provide **the most usefull shell commands** (ls/dir,rm,mv,cp,find,echo,clear,more,env,set,export,history,alias,...), tests commands, **text editor command**, and so on... , covering the fields of file system,text files,console output, data management, user input
- modules can contains any item that the shell is intended to handle: commands, **hooks**, scripts/functions, settings, help, doc, assets, ...
- dedicated repositories are used to get known modules list
- modules are versioned and delivered throught **nupkg** packets, currently hosted at **NuGet**
- modules are installed into the binaries of the shell
 
- modules to be loaded are loaded by the shell kernel on user session startup
 
- _The shell command engine implements:_
- A **command line reader** with:
- usual input keyboard shortcuts
 
- auto completion
- input feedback (colorization)
 
- **Streams** standard input (*stdIn*), standard output (*stdOut*), and standard error (*StdErr*)
- **Streams redirections** ( **<** **>** )
- **pipelines** of commands:
- sequences of commands ( **|** ) and conditional sequences of commands ( **&&**, **||** )
- groups of commands **(** .. **;** .. **)**
- background execution ( **&** )
- commands return a **result code** and can returns **values**
- When returning values and when specified, a pipe ( **|** ) between commands can **pass objects instead of streams**
- **Cancellation** of commands execution **Task** (Ctrl-Z)
- **Batches of commands** (scripts)
- traditional batch of shell commands (.sh,.orbsh)
- C# language scripts (.cssh)
- **Variables**
- Variables can store any data of **any C# object type**
- The command line syntax has been extended to **support an object notation to indicate accessing an object member or invoking an object method**
- Integrates the os shell **environment variables** (with type **String**)
- Are getted and setted with **$** (in any command arg), **set** and **=**
- **Functions** can be defined by a **shell script** or by a **C# compiled source**
- **Aliases** for command names
- **Shell environment** : the shell initialization feature deploy and setup a shell environment for the current user (profile folder and initialization scripts: *.profile*,*.alias*,*.history*,*.orbsh*)
- **Extensibility**:
- The default command line grammar can be changed to get other syntaxes (***zsh***, ***DOS***,...) or a new one
- The command line engine can be overriden and extended to enhance the existing features (auto complete inputs,parsing inputs,running commands,...)
- **A simple way to define shell commands** using C# method and parameters attributes, avoiding the developer to handle syntax analyzing and shell integration (command help, pipelines, standard stream redirections) councerns, allowing to support either simple values types (int,float,string,date time,..) and object types (even generic collection), and that can interacts together and with the shell throught data objects
``` csharp
// a Unix rm command implementation:
[Command("remove file(s) and/or the directory(ies)")]
public
CommandResult<(List items, FindCounts counts)>
Rm(
CommandEvaluationContext context,
[Parameter("file or folder path")] WildcardFilePath path,
[Option("r", "recurse", "also remove files and folders in sub directories")] bool recurse,
[Option("i", "interactive", "prompt before any removal")] bool interactive,
[Option("v", "verbose", "explain what is being done")] bool verbose,
[Option("e", "delete-empty", "remove empty directories")] bool rmEmptyDirs,
[Option("s", "short", "short display: do not print file system attributes when verbose")] bool noattributes,
[Option("m", "simulate", "don't remove any file/or folder, just simulate the operation (enable verbose)")] bool simulate
)
{
var r = new List();
var counts = new FindCounts();
if (path.CheckExists(context))
{
var items = FindItems(context, path.FullName, path.WildCardFileName ?? "*", !recurse, true, false, !noattributes, !recurse, null, false, counts, false, false);
/* ... */
return new CommandResult<(List, FindCounts)>((r, counts), ReturnCode.OK);
}
else
return new CommandResult<(List, FindCounts)>((r, counts), ReturnCode.Error);
}
```
- such a command will be auto documented like this by the shell **help command**:
## Orbital shell uses these libraries:
- Microsoft.CodeAnalysis.CSharp.Scripting
- Microsoft.Extensions.ObjectPool
- Microsoft.Extensions.Hosting
- NewtonSoft.Json
## notice / caveat
> The project orbital shell was dependent of the project **DotNetConsoleAppToolkit**. Now the library *DotNetConsoleAppToolkit* project repository is **ARCHIVED** since it has been integrated into the **orbital-shell** project repository as project **OrbitalShell-ConsoleApp**, so it is still under development but code has been moved to this repository
| :warning: this project might be considered as a toy for old developer
-- | --
*Warning: due to the average age of our main contributors, this project might contains **vintage** architecture,design and code. Nevertheless the source code is intensively based on young devs preferred patterns, C# 8 language usage (intellisense agrees), and it pretends to fit to good practices and architecture guidelines.*