# ⚡ AXION SHELL

this readme contains everything you need to get this thing running and understand what kind of digital creature you just unleashed

---

## 🚀 WHAT THIS IS

a python-powered terminal shell that:

- predicts your commands like it’s reading your mind  
- autocompletes files, folders, and commands  
- runs like a mini OS inside a script  
- remembers your vibe and history  
- lowkey feels like zsh got a cybernetic upgrade  

---

## 🧠 FEATURES

- command autocomplete (tab magic)  
- ghost suggestions (right arrow accept energy)  
- file system navigation baked in  
- custom command runner  
- persistent user identity  
- startup scripting via `config.ix`  
- clean ANSI colored UI  

---

## 📦 INSTALL

```bash
pip install -r requirements.txt

---

▶️ RUN IT

python axion.py

---

⌨️ COMMANDS

files & folders

• ls
• cd
• cat
• mkdir
• rm
• cp
• mv / rname
• mfile

system stuff

• time
• clear
• whoami
• myname
• refresh
• exit / quit

execution

• python

---

⚙️ CONFIG MAGIC

config.ix runs automatically on launch

put commands inside like:

ls
cd test

and it just executes them instantly like it’s obeying your past self

---

📁 STRUCTURE

axion.py
config.ix
requirements.txt

---

💀 FINAL VIBE

this is not a shell

this is a predictive terminal organism that learned your habits and started finishing your thoughts before you do