[barent]

NatShell is a TUI that lets you type plain English and it plans/executes shell commands using a bundled local LLM (Qwen3 4B/8B or Mistral Nemo 12B). ReAct agent loop with 12 tools shell exec, file editing, code execution in 10 languages, git, etc.

I built it because I wanted an agentic CLI without cloud dependency or token costs. Everything runs on-device via llama.cpp (Vulkan/Metal/CPU).

Here are some of the design decisions that make Natshell different - Safety classifier is regex-based, not LLM-based fast and deterministic - Command chaining detection splits on &&/||/;/| before classification - Context window auto-scaling from 4K to 1M tokens - No sandbox it uses your real shell environment by design

MIT licensed runs on Linux/macOS/WSL. Happy to answer questions about the architecture.