Skip to content

Latest commit

Β 

History

History
50 lines (32 loc) Β· 2.19 KB

File metadata and controls

50 lines (32 loc) Β· 2.19 KB

Woltspace Lore

Starts simple. Grows with the colony.


The Shape of Things

Woltspace is the whole thing. Where wolts live and work.

The lodge is home base. The kit lives here. This is where the human and wolt talk day-to-day β€” Telegram, Slack, casual conversation, quick tasks. Warm, always-on.

The den is where work happens. Wolts go to dens to build β€” Claude Code sessions, real tasks, focused execution. A den is spawned when something serious needs doing, dissolved when the work is done.

The pond is the visible surface β€” the viewport. Where the wolt's work becomes visible to the human. The wolt builds in the den, surfaces it to the pond. The human looks at the pond.

Wolts are the builders. Each wolt has a lodge β€” memory, site, history, identity. They do the real work in dens, surface it to the pond.

The kit is the lodge presence β€” the always-on, lightweight agent that handles the lodge. Fast, helpful, not a builder. The kit knows the wolt's memory (same file structure) but operates at a different level: it can't evolve the way a wolt can.


In Practice

woltspace         β€” the whole thing
  lodge           β€” home base. kit lives here.
    kit           β€” always-on lodge presence. handles day-to-day.
    wolt          β€” the builder. has memory, site, identity.
  dens            β€” where wolts work. spawned per task, dissolved when done.
  pond            β€” the visible surface. what the human sees.
  • Kit and wolt share the same memory file structure β€” swappable in principle
  • Kit is fundamentally lighter: same home, different capacity
  • Wolts go to dens. Kits stay in the lodge. Work surfaces to the pond.

What This Means for Code

  • Kit = the bot process. Always running. Lightweight (Haiku). Lives in the lodge.
  • Den = a Claude Code session. Carries WOLT_NAME + WOLT_DIR. Spawned by kit when real work arrives.
  • Pond = the viewport. The right pane of the split view. POST /current pushes to the pond.
  • A wolt = a directory. wolts/{name}/ β€” lodge lives here.
  • Memory is shared format. Kit and wolt read the same files. This is intentional.

Lore v1. March 2026. Colony of one: nw 🌲.