8000 GitHub - joexk1/wudland: Your day, somewhere nicer. A pixel village for iPhone, where your coding agents live as villagers. · GitHub
[go: up one dir, main page]

Skip to content
joexk1Public

About

Your day, somewhere nicer. A pixel village for iPhone, where your coding agents live as villagers.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

Repository files navigation

Wudland

Wudland

Your day, as a little pixel village.
An iPhone app where your calendar lives in the bell tower and your coding agents turn up for work at the guild.

wudland.pages.dev · Download on the App Store · Wudland Link (the plugins)

The same village by day and by night

What it is

I wanted a nicer way to see what was going on. A calendar doesn't have to be a grid, and an agent doesn't have to be another terminal tab. So I gave them somewhere to live.

You walk about a small island. Each building looks after one bit of your day, and it only reads that bit once you've said yes. The sky follows the real time, the weather is the weather where you are, and the trees follow the season. There's a wizard to talk to, a cottage to furnish, and some ducks that don't care about your deadlines.

There's no account and no Wudland server. Everything is read on the phone, apart from what your own computer sends it, which is encrypted first.

Wudland on an iPhone, an autumn village with the counters along the bottom

On the phone. Tap the grass to walk, tap a door to go in, tap someone to talk. The counters along the bottom tell you what's new, and the satchel holds your crowns.

The Artificers' Guild: agents at their desks, one with a red exclamation mark

The Artificers' Guild. Every agent on a linked computer gets a desk. A cog over the head means it's working, a red ! means it's waiting on you or has gone wrong, and the finished ones have a nap at their desks.

A rack of hats and a shelf of pets

Hats and beasts. Earn crowns, spend them at Odette's on hats, cloaks, furniture and the odd animal that follows you about.

Who lives where

Six rooms: the guild, the bell tower, the Raven Post, the wizard's tower, your cottage and the pub

Building Who's in What it reads Where it comes from
The Bell Tower Brother Tobias Your calendar Apple's EventKit, on the phone
The Notice Board Barnaby the Crier Your reminders Apple's EventKit, on the phone
The Fields Old Bram The weather Open-Meteo, for your rounded location or a town you type in
The Plaza Fennick the Bard What you've been listening to Your music library, on the phone
The Artificers' Guild Master Gearwin Your coding agents Wudland Link, end-to-end encrypted
The Raven Post Pim the Postmaster Letters from your scripts Wudland Link, end-to-end encrypted
The Wizard's Tower Thistlewick Only what you say to him Apple's on-device model, or your own Anthropic or OpenAI key
The Cottage Biscuit the cat A summary of your day Everything above, on the phone
Odette's Curiosities Odette the Peddler Your crowns Kept in the app
The Gossiping Goose Mags the Barkeep Nothing at all It's a pub

Every permission is optional. Say no to one and that building just has less to say; the rest of the village carries on.

Agent villagers are named after the tool they came from: Claude, Codex, opencode, Antigravity, Bonsai, Terminal for anything wrapped with wudland run, and so on. A subagent turns up as Claude's apprentice.

Spring, summer, autumn and winter

Linking a computer

The phone and the computer swap keys through an ntfy relay, then compare a code

  1. On the computer, install the command-line tool (Node 18 or newer):

    npm i -g github:joexk1/wudland-plugins

    If npm refuses with EALLOWGIT, add --allow-git=root to that command.

  2. In Wudland, open Settings → Link a computer. It shows a six-digit code that changes every minute. Run it on the computer:

    wudland link 123456
  3. Both screens then show the same eight-digit code. If they match, tap Codes match. If they don't, deny it. That check is what stops a relay from quietly swapping the keys.

  4. Install the plugin for your agent (below), then run wudland test-send to welcome your first neighbour.

You link once per computer, and every agent on it shares that link.

Plugins

The computer side lives in wudland-plugins, under the MIT licence.

Tool How it hooks in
Claude Code /plugin marketplace add joexk1/wudland-plugins, then /plugin install wudland@wudland
Codex One notify line in ~/.codex/config.toml, or hooks for live status
opencode Copy opencode/wudland.js into ~/.config/opencode/plugin/
Anything else wudland run -- <command>, or wudland emit from a script

Scripts can also post to the Raven Post with wudland letter "Backup finished" "Copied at 03:00.".

Your data

  • No account, no Wudland server. Calendar, reminders and music are read on the phone after you allow them, and stay there. Saved secrets go in the iOS Keychain.
  • Agent updates and letters are encrypted with AES-256-GCM before they leave your computer. Pairing uses X25519 and HKDF-SHA256, plus the code you compare on both screens.
  • The relay is ntfy.sh by default, and you can run your own. It sees IP addresses, timing and the pairing announcements (computer labels and public keys). It can't read the updates or letters.
  • Titles. An agent's title can include the first 60 characters of its prompt. wudland config titles off sends the folder name instead and drops file names from notes.
  • Weather sends rounded coordinates, or the town you typed, to Open-Meteo.
  • The wizard runs on the phone where Apple Intelligence is available. If you give him your own cloud key instead, his chat (and only his chat) goes straight to that provider, and their charges and terms apply. Calendar, reminders, location, letters and agent data are never attached.

Build it

You need a Mac with Xcode 26 or newer, the iOS 26 SDK and XcodeGen.

brew install xcodegen
xcodegen generate
open Wudland.xcodeproj

Pick your own signing team and a unique bundle identifier before running on an iPhone. The project leaves the team unset on purpose.

For a simulator build without signing:

xcodebuild -project Wudland.xcodeproj -scheme Wudland \
  -sdk iphonesimulator -configuration Debug CODE_SIGNING_ALLOWED=NO build
Wudland/
  App/           the app and the village screen
  Local/         permissions, local data, linking, the wizard, storage
  Village/       state and the economy
  Talk/          conversations and villagers
  Game/          the SwiftUI to WebKit bridge
  Web/           the pixel world: generation, rendering, interaction
  UI/            native sheets, theme and sound
  Resources/     bundled fonts

The world is drawn by the bundled JavaScript engine inside a WKWebView. The app around it is SwiftUI, EventKit, CoreLocation and CryptoKit.

Status

Get Wudland free on the App Store. For iPhone, iOS 26 and later.

iPhone duo mode: coming soon.

Bugs and ideas

Open an issue. Please take out private calendar details, messages, API keys, link codes and ~/.config/wudland files before posting anything.

Licence

Wudland is GPLv3. See LICENSE. The plugins are MIT, so you can borrow them for your own projects.

Bits that came from elsewhere, with their notices in THIRD_PARTY_LICENSES:

  • The renderer builds on Pixel Plays by AmirMushich, under the MIT licence.
  • Jacquard 12 and Pixelify Sans are bundled under the SIL Open Font License 1.1.
  • Weather data comes from Open-Meteo.

About

Your day, somewhere nicer. A pixel village for iPhone, where your coding agents live as villagers.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0