Skip to content

v0.1.0 — Initial Release

Choose a tag to compare

@EvanZhang008 EvanZhang008 released this 08 Mar 20:17

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 start to 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 web

Open 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