A modern shell built in Rust for Unix-like systems, with macOS as the primary development platform.

Astra is an interactive command-line environment focused on a clean interface, customization, and a better terminal experience. It combines the power of traditional Unix shells with a modern prompt system, configuration, and extensibility.

Check out our documentation here!

• Features
• Screenshots
• Installation
• Requirements
• Usage
• Themes
• Why Astra?
• Contributing
• License
• Status

• Interactive Rust shell
• Configurable prompt engine
• Multiple built-in themes
• Git-aware prompt information
• Command history
• Tab completion
• Alias support
• TOML configuration
• Built-in shell commands
• Modular architecture
• Plugin framework (in development)
• Optional built in AI plugin

Coming soon.

• Rust stable toolchain
• Cargo
• A Unix-like operating system (macOS officially tested)

Install Rust:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Clone Astra:

git clone https://github.com/SYOP200/astra-shell
cd astra-shell

Build:

cargo build --release

Run:

./target/release/astra

Start Astra:

astra

Example:

Crimson

 git: main
◉ finn@MacBook-Air
📁 ~/Developer/astra-shell
14:27
❯

Astra executes standard system commands:

ls
cd Projects
git status
python3 script.py

Built-in commands:

cd
pwd
clear
history
exit

Astra uses:

~/.astrarc

Example:

[general]
theme = "crimson"

[prompt]
show_git = true
show_directory = true
show_time = true

[aliases]
ll = "ls -la"

Built-in themes:

• crimson
• midnight
• matrix
• obsidian

Themes control:

• Prompt layout
• Prompt symbol
• Displayed information
• Overall appearance

src/
├── main.rs
├── shell.rs
├── prompt.rs
├── parser.rs
├── executor.rs
├── builtins.rs
├── history.rs
├── config.rs
├── theme.rs
├── git.rs
├── completion.rs
└── aliases.rs

Each module has a focused responsibility to keep the project maintainable.

• English
• Deutsch
• español
• 简体中文
• français
• 日本語

These languages were translated automatically by AI using Translate.js If there are any spelling errors, report them.

Astra is an experimental shell written in Rust with an emphasis on readability, modularity, and customization. The goal is to provide a clean foundation that can evolve while remaining approachable for contributors.

Contributions are welcome.

git checkout -b feature-name
git commit -m "Add feature"

Then open a pull request.

Astra is licensed under the MIT License.

Astra is currently in active development.

The core shell, prompt system, configuration loader, history support, themes, and documentation are in place. Current work focuses on command execution, built-in functionality, testing, and release packaging.