This is a shell built for the "Build Your Own Shell" Challenge.

In this challenge, you'll build your own POSIX compliant shell that's capable of interpreting shell commands, running external programs and builtin commands like cd, pwd, echo and more. Along the way, you'll learn about shell command parsing, REPLs, builtin commands, and more.

Note: If you're viewing this repo on GitHub, head over to codecrafters.io to try the challenge.

🦀 Clawsh

A small, sharp, Rust‑powered shell with bite.

Clawsh is a Unix‑style shell written in Rust.
It supports pipelines, redirections, builtins, and external commands.
Originally built as a Codecrafters challenge, it has grown and popped it's shell onto crates.io.

Features

Builtin commands (cd, pwd, echo, type, history)
Pipelines (ls | grep foo | wc -l)
Redirections (>, >>, 2>, 2>>)
External command execution
Persistent history with append/read/write modes

Installation

From crates.io

cargo install clawsh

🧪 Usage

Start the shell:

clawsh

Examples:

clawsh
$> echo hello world
hello world

clawsh
$> ls | grep rs | wc -l

clawsh
$> history -a ~/.clawsh_history

Roadmap

[] add robust error handling
[] add docs
[] implement more builtin commands when codecrafters updates their course

📄 License

MIT or Apache-2.0