anvell

a simple custom shell built with C++ while learning systems programming

build

g++ -std=c++17 main.cpp -o anvell
./anvell

features

• flow control: piping |, redirection >, >>, input <
• tokenizer: handles 'single' and "double" quotes
• stats: execution time for slow commands (>0.1s)
• persistence: stores aliases, history, and notes in ~/.anvell_*

commands

• hop [n] - jump to frequent directories
• jot "msg" - save ephemeral note
• jots - view notes
• packitup - delete all notes (clear workspace)
• dub key="val" - create alias
• nix key - remove alias
• say msg - echo text
• vars - list env vars
• set VAR=val - set env var
• reset - clear jump history

example

anvell 0.5

~ > dub ll="dir"
~ > ll > files.txt
~ > jot "files saved"
~ > jots
[2026-01-31 20:04] files saved
~ > packitup
~ >

internals

written in c++. uses fork/execvp on *nix and _spawnvp on windows. custom state-machine tokenizer with no external dependencies

license

MIT. See LICENSE file