Claude Code, as a cozy village

Your AI agents live here.

Every Claude Code session becomes a villager you can watch, steer and approve. Give them work, answer their questions, and read the results as letters.

Get Hokkoro, free See it in 30 seconds

Runs on your Claude Code or your own key. Your code stays with you.

The village square: five workshops around a cobbled plaza, villagers at their worktables
✉️ A letter from Wren
Launch checklist: 12 items, 3 of them need you.
✋ Pim needs your OK
May I run npm test on the workbench?
AllowAlwaysRefuse
Thirty seconds in the village

Say it. Approve it. Read it.

1

Say what you need

Type or say it. Start with a name to go straight to someone, or let your assistant hand it out.

Wren, draft the launch post
2

Approve what they ask

A coin lights up over their head when they need your OK. Allow it once, always, or refuse with a reason.

May I fetch your pricing page?
3

Read the letter

Finished work lands in your mailbox. Copy it, or send it back with a note on what to change.

Here is your launch post, two versions.
A conversation with a villager: the chat on the right, the villager on the left
Claude Code at heart

A real agent tool, dressed as a village.

Under the thatched roofs it is the agent workflow you know, calm and easy to follow.

  • 🧭
    Every step, in plain wordsEach tool call shows in the thread, in the villager's own voice. Open any step for the detail.
  • ✋
    Approvals find youAllow, refuse with a reason, or always allow a kind of action. Take it back any time in Settings.
  • 🐾
    Subagents become apprenticesWhen a session sends a helper, a little apprentice comes out beside it with its own job and steps.
  • ✉️
    Results arrive as lettersReady to read, copy or send back with a note.
// ~/.claude/settings.json: every session visits your village
"hooks": {
  "PreToolUse": [{ "hooks": [{ "type": "command", "command": "node village-hook.mjs" }] }],
  "Stop":       [{ "hooks": [{ "type": "command", "command": "node village-hook.mjs" }] }]
}
A villager's workshop: a map table, a bookshelf and a workbench, and the panel that puts them in
Workshops

What stands in their workshop is what they can do.

Tools you can see. Put a piece in, and the villager can use it from their next step.

  • 🗺️
    Map tableReads web pages. You approve each site.
  • 📚
    BookshelfA shared library of files they write and read back, yours to download.
  • 🔧
    WorkbenchRuns small programs in a sealed sandbox: no files, no keys, five seconds.

When a job needs a piece they do not have, they ask you for it.

Lo-fi mode: the village through a window at dusk, rain on the glass
Lo-fi mode

Leave it on while you work.

Rain on the window, soft beats, your villagers at work. It knocks when someone needs you.

Seven worlds, more coming

Move house any time.

Every world has its own look and its own cast. Your villagers keep their memory wherever they live.

Cozy village
Cozy villageCottages round a cobbled square, slow afternoons
Fantasy realm
Fantasy realmA great oak, banners and a waterfall
Magic academy
Magic academyTowers, a great hall and a lake below
Wizard's tower
Wizard's towerBooks, potions and a spell circle
Space colony
Space colonyDomes under a ringed giant
Robot depot
Robot depotConveyors, parcels and very busy robots
The office
The officeYour team's pod on a calm blue floor
Villagers as people in academy robes
Made for long days

Calm by design.

  • 🧑‍🤝‍🧑
    Characters or peopleKeep the animal cast, or make your villagers people: ten bodies, any skin, hair and clothes, dressed for each world.
  • 🔔
    Pings that matterOne card when someone needs you, a desktop alert only when the tab is in the background.
  • 🎙️
    Order by voiceHold V and say it. A spoken order waits a moment before it goes.
  • 📸
    Photo modeFreeze the moment your village shipped something.
For teams Coming

Every teammate's village, on one map.

A helper does the rounds: who is blocked, what shipped, what waits on whom. Read from the agents' work, never from screens or keystrokes. Everyone sees what the lead sees.

Questions

Good to know.

Is this a game or a work tool?

A work tool first. Your villagers are real AI agents doing real jobs. The village makes it pleasant to watch, easy to follow and hard to forget about.

Do I need Claude Code?

No. You can connect an API key, or try everything in demo mode where the villagers act their jobs out. Claude Code users get the most out of it: every session and subagent shows up as a villager.

Where does my work go?

Your agents run with your own keys or subscription. Nothing your villagers do is shown to anyone else unless you share it.

Will it slow down my laptop?

It adjusts its graphics to your machine and steps down when things get busy. You can pick a lighter setting any time.

How do I get it?

Open a terminal and run npx hokkoro. Your village opens in the browser and runs on your computer. You need Node 20.11 or newer. A phone app is coming soon.

Move in today

Your village is waiting.

Free. It runs on your computer, with your own agents. Open a terminal and run:

npx hokkoro

Needs Node 20.11 or newer. Phone app coming soon.