NPC-Worldwide (primary contributor cagostino) presents npcsh, a composable multi-agent shell that interprets both bash commands and natural language within a single interactive interface. Built primarily in Rust with a Python backend (npcpy) for the LLM inference loop, it lets users delegate tasks to named agents, define custom "Jinxes" (Jinja Execution templates) for tool-use and skills, and works with any model provider LiteLLM supports. A 100-task benchmark suite scores how well various models can drive the shell, with results ranging from 23% (Qwen3.5 0.8b) to 97% (Qwen3.5 35b, Ornith 35b, Kimi K2.7-Code 1t).
- Agent definitions support three interchangeable formats: .npc YAML files, agents.md markdown, and agents/ directories with per-agent .md files
- The Python backend (npcpy) is explicitly temporary and slated for replacement by a Rust-native runner (npcrs)
- The project references an arxiv paper on "ALARA for Agents: Least-Privilege Context Engineering Through Portable Composable Multi-Agent Teams"
- Supports local model runtimes including Ollama, LM Studio, and MLX (Apple Silicon)
- Currently at v2.1.16 with 128 releases, 473 stars, and 854 commits
- Agent definitions support three interchangeable formats: .npc YAML files, agents.md markdown, and agents/ directories with per-agent .md files
- The Python backend (npcpy) is explicitly temporary and slated for replacement by a Rust-native runner (npcrs)
- The project references an arxiv paper on "ALARA for Agents: Least-Privilege Context Engineering Through Portable Composable Multi-Agent Teams"
- Supports local model runtimes including Ollama, LM Studio, and MLX (Apple Silicon)
- Currently at v2.1.16 with 128 releases, 473 stars, and 854 commits
