v0.1.0 — Initial Release
First public release of Walnut — a personal AI butler powered by Claude.
Highlights
- Claude Code Web UI — spawn, monitor, and chat with Claude Code sessions from a real-time web dashboard
- 4-layer task hierarchy — Category → Project → Task → Subtask with 7-phase lifecycle
- AI agent with 30+ tools — task management, memory, sessions, search, cron, coding, and more
- Persistent memory system — per-project memory, daily logs, session summaries, full-text + semantic search (SQLite FTS5 + BGE-M3 embeddings)
- Multi-session orchestration — run up to 7 local + 20 remote Claude Code sessions simultaneously
- Local-first — all data stored in
~/.walnut/as JSON, Markdown, and SQLite - Self-hosted — single
npm install && npm startto run everything - Heartbeat system — periodic AI self-check with configurable schedules
- Cron jobs — schedule recurring agent tasks with cron expressions or intervals
- Plugin system — Microsoft To-Do two-way sync, Slack notifications, extensible plugin architecture
- Git-sync — automatic version-controlled backup of all task and memory data
- CLI + Web — full CLI for terminal users, React SPA for the browser
Getting Started
git clone https://github.com/EvanZhang008/walnut.git
cd walnut
npm install
npm run build
cd web && npx vite build && cd ..
walnut webOpen http://localhost:3456 and start chatting with your AI butler.
Requirements
- Node.js >= 22
- Claude API access (via AWS Bedrock)
- Optional: Ollama with BGE-M3 for semantic search