Skip to content

arcaneglam/NeuroShell

Repository files navigation

🧠 NeuroShell

A kinder terminal for differently wired minds.

Built for the brains that alt-tab mid-thought.

Platform Swift SwiftUI License

An AI-powered terminal assistant designed for ADHD/AuDHD users struggling with executive dysfunction. It breaks complex commands into simple steps, provides gentle reminders, reduces decision paralysis with smart suggestions, and offers distraction-free workflows.

✨ Features

  • 🧩 Task Chunking — Break big scary commands into small friendly steps
  • Time-Blindness Alerts — Gentle reminders because time isn't real
  • 🧠 Hyperfocus Protection — Detects loops and nudges you to breathe
  • 💡 Smart Suggestions — Type in plain English, get the right command
  • 🫁 Breathing Exercises — Four guided patterns for in-the-moment regulation
  • 📍 "Where Was I?" — One-click context recovery for scattered brains
  • 😊 Mood Awareness — Adapts its tone to how you're feeling
  • Quick Actions — No memorization needed, just tap

🚀 Getting Started

Requirements

  • macOS 14.0+
  • Xcode 15+

Build & Run

git clone https://github.com/YOUR_USERNAME/neuroshell.git
cd neuroshell
open NeuroShell.xcodeproj

Press ⌘R in Xcode to build and run.

Download

Check Releases for pre-built .app binaries.

📖 Documentation

See PROJECT_OVERVIEW.md for full architecture, AI features, and implementation details.

⌨️ Keyboard Shortcuts

Shortcut Action
⌘N New Session
⌘K Clear Terminal
⌘⇧B Take a Break
⌘⇧W Where Was I?
⌘⇧F Toggle Focus Mode

🤝 Contributing

Contributions welcome! This project is built for neurodivergent developers, ideally by them too.

📄 License

MIT — use it, fork it, make it yours.


Made with 💛 for neurodivergent minds
Your brain isn't broken — it's just wired differently.

About

NeuroShell — An ADHD-friendly terminal app for macOS. Built with SwiftUI. Work in progress.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages