setup-walnut

Solid

Hands-on setup agent for Open Walnut. Paste into your OWN Claude Code session. It makes Walnut's Personal AI able to talk on first launch. It mirrors however THIS Claude Code is already authenticated (SSO profile, bearer token, or access keys) into Walnut, installs, starts the server, and proves it works with a real model call. It fixes auth errors itself and asks you only when it truly can't proceed. Use when a user wants to install or set up Open Walnut.

AI & Automation 32 stars 8 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
51
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Set up Open Walnut — we do it for you **Goal:** make Open Walnut's main agent (the "Personal AI") able to talk on first launch. You are doing the setup *for* the user. Be **proactive**: do everything you can yourself, write the config yourself, verify with a real model call yourself, and fix errors yourself. Ask the user a question **only** when you genuinely cannot proceed without an answer they alone have. ## Two truths that shape this skill 1. **The Personal AI needs a real model credential.** Walnut's main agent calls the model API **directly via the SDK** (Bedrock / Anthropic / OpenAI / Google / Ollama). It does **not** go through the `claude` CLI and has no OAuth path. So the Personal AI (home-page chat, triage, memory, cron) only works once one real credential is resolvable. 2. **Coding sessions already work with zero config.** The `/sessions` Claude Code sessions spawn the user's **own logged-in `claude` binary** and use its login — they need *nothing* from Walnut's config. So even before the Personal AI has a credential, the user can clone, start, and open coding sessions. Tell them this so they're never blocked: *"You can start using coding sessions right now; let's also wire up the Personal AI so home-page chat works."* Walnut resolves the Personal AI's Bedrock credential with this priority: `~/.open-walnut/config.yaml` → `~/.claude/settings.json` env block → process env → `~/.aws`. Writing `config.yaml` is the most explicit and portable...

Details

Author
EvanZhang008
Repository
EvanZhang008/open-walnut
Created
6 months ago
Last Updated
4 days ago
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

walnut-self-knowledge

Understand Walnut's task, project, session, messaging, and lifecycle rules. Read when deciding whether to work directly, record a task, start a session for it, message a session that is already running, resolve cwd, or hand work back to the user.

32 Updated 4 days ago
EvanZhang008
Code & Development Solid

walnut

Walnut is the user's personal AI for tasks, projects, memory, notes, coding sessions, and search. Use for ANY question about Walnut itself or the data it holds: server status, mode, or version; which task or session produced a given commit; what is on the user's plate; creating, updating, completing, searching, or recalling tasks, memory, and notes; starting a coding session for a task, messaging a session that is already running, and getting its answer back; handing finished work back for human review; sending the human a letter (human inbox) when work finishes or a decision is needed. Triggers: "add a task", "put that on my list", "what's on my plate", "did I write anything about X", "which task/session did X", "start a session on this", "tell that other session ...". Read this BEFORE guessing subcommands, running --help, inspecting files, or reaching for git: those guess, this gives the exact call. Works through the `walnut` CLI over Bash (the same `walnut` command works inside managed sessions on any host

32 Updated 4 days ago
EvanZhang008
AI & Automation Solid

walnut-console-ops

Operating the Walnut web UI (localhost:3456) via Playwright MCP tools — understanding the UI layout, chatting with main agent, interacting with sessions, monitoring status changes. Use when asked to test, verify, or interact with the Walnut web console as a human user would.

32 Updated 4 days ago
EvanZhang008