A POSIX-compatible modern shell with an AI-native context engine. Takes the best from bash, zsh, fish, and nushell — without breaking your scripts.
| Shell | What modsh inherits |
|---|---|
| bash | POSIX compatibility, scripting reliability |
| zsh | Rich completion, plugin architecture, globbing |
| fish | Autosuggestions, syntax highlighting, human-friendly UX |
| nushell | Structured data pipelines (opt-in) |
Plus: a local-first AI context engine that learns your projects, habits, and environment — and compounds over time.
modsh
├── Core Shell (POSIX-compatible) Apache-2.0
├── Extended Interactive Layer Apache-2.0
└── AI Context Engine (HyQAI-ready) BSL 1.1
See ARCHITECTURE.md for full design.
modsh-ai integrates directly with cargo-skill.
Running cargo skill in a modsh project activates the appropriate skill scope for the
current session:
| Command | Effect in modsh-ai |
|---|---|
cargo skill lookup <prefix> |
Narrows AI suggestions to that rule domain |
cargo skill think |
Activates lookup + reasoning layers |
cargo skill write |
Activates all layers — full execution context |
cargo skill clear |
Resets to default inference (no skill scope) |
The .skill/context.md file written by cargo-skill is read by modsh-ai at session
startup. No daemon, no IPC — file-based handoff only.
modsh uses a dual-license model:
- Core shell (
modsh-core,modsh-interactive): Apache-2.0 - AI context engine (
modsh-ai): BSL 1.1 — free for non-production use; commercial license required for SaaS/enterprise deployment
Pre-alpha. Not ready for use.
See TODO.md for the full roadmap.
# Prerequisites
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
cargo install cargo-audit
cargo install cargo-watch
cargo install cargo-nextest
cargo install cargo-skill
# Clone and build
git clone git@github.com:SHA888/modsh.git
cd modsh
cargo buildNot open for contributions yet — pre-alpha phase. Watch the repo for updates.
Follows SemVer. Current: v0.1.0-alpha.