Open Walnut: Claude Code agents run as a project team
Open Walnut
A web app runs a lead agent, project leads and Claude Code worker sessions, with tasks, notes and memory alongside
- 140 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The app launches Claude Code sessions with your permissions on local and remote machines over SSH
- The dashboard has no login, so public access without protection exposes control of the agents
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/open-walnutDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The app launches Claude Code sessions with your permissions on local and remote machines over SSH
- The dashboard has no login, so public access without protection exposes control of the agents
This is third-party code. Review the repository files before installing.
What it does
Open Walnut is a self-hosted app in which AI agents run work like a small company. You talk to one director agent, and each project has its own lead that starts Claude Code sessions and workers. The Org page shows where your answer is needed, and you can reply right there. Tasks (a hierarchy of project, folder, task, subtask), Markdown notes with links, a calendar and long-term memory sit alongside. All coding sessions are gathered on one page: Claude Code, Codex, Gemini, OpenCode and Goose, on your laptop or a remote machine over SSH. Sessions survive a browser drop, an SSH drop and a server restart. For review there is a per-session diff with line comments sent back to the same session. Start with `walnut web`, then open `localhost:3456`. Every AI turn goes through the `claude` you have installed, so an Anthropic API key is needed only for small single calls. Data is stored in `~/.open-walnut/` as JSON, YAML, Markdown and SQLite, and there is no telemetry.
Who it is for. People who run several projects and Claude Code sessions at once and want tasks, notes and agents on one page in place of terminals and Notion.
Good fit when
- Several projects run and each needs its own lead who plans the work and hands it to workers
- Claude Code sessions on a laptop and on a remote machine should be watched in one window
- After an SSH drop a session should keep running and not get lost
- A session diff should be commented line by line and the notes sent back to the agent
- You want tasks, notes and memory stored locally in files and not in a cloud service
Not a fit when
- You work on one task and need no agent hierarchy: the app pays off with several projects
- Claude Code is not installed and signed in: every AI turn goes through it
- You want the app exposed to the internet: the dashboard has no login and should be exposed only behind protection such as Cloudflare Access
- You need cloud agents: Walnut runs on your machine
Example request
Run walnut web, create a project with a lead and set fixing a failing test as the first task. Show on the Org page what is waiting for my answer.Limitations
Claude Code installed and signed in once is required: every AI turn, including quick questions and routines, goes through it. Other agents (Codex, Gemini, OpenCode, Goose) must be installed beforehand. macOS 12 and newer and Linux with glibc 2.28 and newer on arm64 and x64 are supported.
The dashboard has no login, so expose it to the outside only behind protection such as Cloudflare Access and share the link with nobody. An npm install requires Node.js 22 or newer. The project is young and updates often: `walnut update` installs a new version and `walnut doctor` checks the state.
How to disable. Stop the server and remove the app the way you installed it: `brew uninstall open-walnut` or `npm uninstall -g open-walnut`, or delete the binary from `~/.local/bin`. Data lives in `~/.open-walnut/` and `~/.local/share/open-walnut`, and you can delete it by hand.
FAQ
How do I install Open Walnut?
Use `brew install evanzhang008/tap/open-walnut` on macOS, `npm install -g open-walnut` (Node.js 22 required) or the `curl | sh` installer from releases. After installing, run `walnut web` and open `localhost:3456`.
What is needed besides the app itself?
Claude Code installed and signed in: sessions, quick questions and routines go through your `claude`. Sign-in with an Anthropic account, Bedrock or Vertex works equally.
Which agents are supported?
Claude Code by default, plus Codex, Gemini, OpenCode and Goose in the same columns. Their CLIs must be installed beforehand.
Where is the data stored?
Core data is stored in `~/.open-walnut/` in JSON, YAML, Markdown and SQLite files. The project is local-first, sends no telemetry and is MIT licensed.
How do I update?
Run `walnut update`, and `walnut update --check` only reports a new version. Homebrew updates with `brew upgrade open-walnut`, and `npm install -g open-walnut@nightly` switches to the nightly channel.
Discussion
No questions or reviews yet.
Related
CLI toolsOpenCove is a desktop app that lays out Claude Code and Codex sessions, terminals and notes on an infinite canvas
The /myoffice command opens a browser office showing what every agent on your machine is doing: thinking, waiting for you or done.
A scaffold for Claude Code and Codex: tasks in files, developer and QA roles, manual approval and shared state.
Agent Standup shows Claude Code, Codex and Mistral Vibe sessions as a live team call: who works, who waits.
Local AI commands for voice and text: clipboard dictation, text fixes, speech, an assistant and parallel agents in worktrees
CodeKanban gathers terminals and Claude Code and Codex sessions on one page, and codekanban-cli drives them from an agent
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Open Walnut: Claude Code agents run as a project team (this card) | no | 140 | |
| Kanban | no | 1,384 | a task board for one agent, while Walnut runs a hierarchy of director, leads and workers |
| Conductor | no | 3,791 | a planning plugin for Claude Code without its own task and note dashboard |
README in short
The README opens with the promise of replacing Notion and Claude Code terminals with one app where agents run work like a company. Then it lists the capabilities (organization, personal AI, session workspace, review, tasks, notes), requirements and a quick start in three ways. At the end it describes updates and release channels.