This repository was archived by the owner on May 23, 2026. It is now read-only.
Repository navigation
v0.1.0
shell-agent v0.1.0
macOS GUI chat and agent tool powered by local LLM.
Highlights
- Wails v2 + React desktop app with dark translucent theme
- Shell script Tool Calling with MITL approval for write/execute operations
- MCP support via mcp-guardian (multiple servers)
- Hot/Warm/Cold memory with LLM summarization and timestamp-aware temporal reasoning
- Pinned Memory — autonomous important fact extraction across sessions
- Multimodal — image input with smart image recall (view-image tool)
- Security — nlk/guard, jsonfix, strip integration
- SwiftUI launcher — menu bar resident with Ctrl+Shift+Space global hotkey
- Settings UI — in-app configuration
- Session management — auto-generated titles, rename, delete
Requirements
- macOS 14+ (launcher), macOS 10.15+ (main app)
- LM Studio or OpenAI-compatible API server
- Default model: google/gemma-4-26b-a4b
Build
cd app && make build
cd launcher/ShellAgentLauncher && swift build