Repository navigation
Releases
v0.5.1
Changed
- The reference describes a group as it is drawn now, and has an entry for the kerb.
Pointing at a group's line names it as the group, and its card says which site it leads into, not a station.
Fixed
- Moving a session into a team's group, or starting one from it, puts it there.
The move said it was done and left the session where it was,
and a group the team was remembered in could show up twice. - Moving a session into a group takes at once, even when nothing is working.
With the daemon running, a move, a rename, taking a session out or muting a word waited for the next change anywhere in~/.claude, so in a quiet city it never took.
The daemon now watches the groups file itself. - A move says it moved only once it has.
It says "moving to" a group until the map shows the session there, then "moved to" it.
A move that could not be written says why instead of claiming it moved, and one that has not shown after ten seconds says it has not taken. - "While you were away" lists each session once.
A session that needed you several times while you were gone has one row, its latest, saying how many times.
The full timeline still lists every event.
v0.5.0
Added
- A group's sessions sit together, inside a kerb.
A new session takes the free lot nearest the rest of its group in its district, so a group reads as a neighbourhood.
A session in no group leaves the lots beside a group free while it can.
A low light kerb runs round each neighbourhood of two or more buildings, so a group is found without reading a badge.
Moving a session into a group, out of one, or taking it out carries its building to its new lot, and the move is drawn: the building fades out where it stood, a truck carries its crate across, as packing does, and it fades in where it lands.
A team moves as a convoy.
Groups the city guesses move nothing, so no building moves unless you moved it. - How a group's line is drawn is a setting.
group_line_form, in the settings panel beside group lines, draws a group's line between its districts, the default, as outlines round its buildings in each district with links between them, or from building to building.
It changes the map at once.
Changed
- A key is drawn one way everywhere, as a key cap.
Hover a button on a session's card to see what it does, and its line ends with the keys that do the same.
The action menu's line for the row you are on ends with the keys that run it from the map.
A dialog's keys under its buttons are caps too, one per key.
A rebound key shows as bound. - Hold
eto see every key.
While the explain key is held, every control on screen that a key also does wears that key: the card's buttons and numbers row, the needs-you count, the lens panel, the stream and the sidebar, or a list's first nine rows when one is open.
It works over the action menu and dialogs too, and in a list until its filter takes letters.
The first card you open says which key to hold, once. - The action menu opens from its button.
Opened from a card's button, it hangs just under that button, raised over the card with a shadow and a lighter surface and a notch pointing at the button; space opens it under the Session button.
The button stays pressed with its chevron turned up while the menu is open, and the column it opened lights.
A right-click still opens it at the pointer. - The bottom bar is gone and the map is taller; hold
efor every key.
The map runs to the window's bottom edge, and a fitted view uses the room.
Hovering a count on the top strip names the key that opens the reference, as it is bound.
While a first launch reads your history, its progress line is a band along the bottom until it is done. - Panel headers are shorter, and say no keys.
A panel's header and its buttons say what they are; holdeto see their keys, or open the reference with?.
City Hall's board, the clinic, the group picker, close-up, the journal, the dive, the long-range panel, the walk's buttons and the statistics prompts all moved their keys to caps.
Share mode and the New session panel, where holdingecannot help, keep their keys on a line of caps.
City Hall's board says "1 group", not "1 groups". - A group's line has no stations.
The line runs between buildings, not to dots floating beside them.
A link into a site that waits on another is drawn dark, and one into a site joined on a guess is dashed.
Pointing at a link shows what its station showed: the group, the site and the route.
A building's card says which site of the line it is and what the site waits on.
Dropping a carried building on a link, or on any building in a group, moves it into that group.
Pull requests opened outside a group, and districts only a coordinator's subagents worked in, are no longer drawn on the map; the dive and the stand-up still list them. - Pointing at a session in a group lights the whole group.
The rest of the city fades, as it does when a group is focused, and in the Connections lens the towers that session calls stay lit with only its own lines to them.
A session in no group, or alone on the map in its group, lights as before, and a selected session with the pointer elsewhere still lights only itself. - What the city dims, it now dims clearly.
Pointing at something, focusing a group or filtering the finder used to leave everything else faintly pale, which barely read at the fitted view.
Everything outside the answer now goes dark grey. - Deleting and closing ask in a dialog.
Demolishing a session and closing a group used to arm on the first key and say "press again" in the footer.
Each now opens a dialog in the middle of the window, as Quit does, saying what it will do, with the keys that answer each button under it.
d dstill demolishes andDelete Deleteon the board still closes a group: the first press asks and the second confirms. - The top bar's needs-you count is a button.
The line at the bottom naming who has waited longest is gone.
Clicking the count in the top bar now attaches that session in one click, as the line did, and hovering it lists who needs you, longest-waiting first.
tabstill walks them one at a time. - A button says what it is doing.
While stop, resume, fork or remove runs, its button on the session's card reads stopping…, resuming… and so on until it is done, and Pack up everything quiet reads packing up….
When nothing on screen carries it, such as a new session started from its panel, one message under the top bar says what was started.
A failure says what went wrong there; a success needs no message, since the building changes. - On a home with thousands of sessions, the daemon looks again for about a third less CPU.
With 2,000 sessions a look costs about 12 ms of a core, where it had crept up to 17 since 0.3.4.
The daemon spends its 1% of a core on looking, so a reply now reaches the map about every 1.2 seconds rather than 1.7.
v0.4.1
Added
- A water tower's lines run to the buildings on the map, or to the depot too.
A packed session kept its line from every tower it ever called, so a depot of ninety crates had thin lines across the whole empty south of the map.
The lines now run to the buildings on the map, and the Connections lens's panel says what they cover and switches the depot's crates in and out.
The switch is thetower_linessetting,buildingsorall, which the settings panel carries too.
Changed
- What just happened shows under the top bar and in the stream.
A passing message used to be a small line at the bottom-left, above the key row.
It is now one plate top-centre, just under the top bar, in body type, with a dot in its state's colour and, when a key acts on it, that key as a cap.
One shows at a time, for four seconds or until the next.
Every one is also the stream's newest line, so a message that passed can still be read, and clicking it there flies to its session as the stream's other lines do.
A lens change, a camera turn, a change of light and showing or hiding a panel no longer make one.
Triage says which step of how many in the header of the session's card instead of on the footer.
Fixed
- A teammate is in its lead's group, always, and moves with it.
A team was only evidence that its sessions were related, so a team too large to be evidence, a pair marked not related, or a move of the lead alone could leave a teammate in another group, or in none, with no way to move the resting ones.
Now a teammate follows its lead: into the lead's group, out of it, or into none, and a team on its own is one group.
Moving or taking out any session in a team, resting or not, acts on the whole team, and the card says so.
Closing a group still packs every member, teammates included. cwith nothing under the pointer asks where.
With no building selected and no district under the pointer,cused to refuse with a footer note.
It now opens New session on its directory field, so a session can start anywhere from the map.
A selection or a hovered district still starts a session there at once.- A group with one session on the map is shown.
A group was hidden until two of its sessions were on the map, so a group just made from move to group vanished from the board, the picker and its member's card, and two such sessions could not be put together.
Now every group with a session on the map is on the board, in the picker and on its member's card, with a badge and no line.
A group with none on the map stays off, and the tidy-up walk still asks only about groups with two or more. - Pointing at a water tower lights its lines.
The sessions that call the server lit up while the lines to them stayed as they were, among every other tower's.
Now the tower's lines light with it and the other towers' lines fade with the rest of the city;
pointing at a session lights its own lines the same way. - A session that pauses for a second or two mid-work stays working.
Each turn's end flipped the building to needing you at once, so a session that ended one turn and started the next a moment later pulsed, logged aneeds-youline and sent a desktop notification for a pause nobody needed to see.
The daemon now holds a working session as it was for three seconds after its turn ends, and shows it needing you, logs the event and notifies only if nothing new has happened by then; the map,status,bar,notifyandeventsall read the same hold.
A permission prompt, a question, a session ending and a session working again still show at once.
v0.4.0
Added
- Tidy up: a quick walk through what changed while you were away.
When a city opens for the first time, or after more than a week away (tidy_days), and there is something to tidy, a short walk opens, one card at a time.
The first card offers Start clean, which packs up what had gone quiet before you left and keeps the groups the city found, all in one step.
It also offers Walk through it and Later.
Walking through, each group gets its own card, the busiest and largest first, with its members listed and the camera on its line.
Keep it, rename it, drop it, split it by directory, or take one member out.
A last card offers to pack up every session in no group that has been quiet for a week.
Esckeeps what you decided and leaves the rest as the city's guesses until the next long gap.
City Hall's board opens the walk any time with Tidy up (t), and so does the journal when it has something to offer. - Pack up everything quiet.
One button on City Hall (p) packs every session in no group that has rested forquiet_daysinto the depot as a convoy, saying how many before and after.
Unpack any of them from the depot, or just use one again, and it comes back. - Groups can be renamed, closed and corrected.
Rename a group from its board row (F2) or a member's card, and the name sticks.
Close group packs every session in it into the depot and takes it off the board, and unpacking any of them brings it back.
A group whose every pull request has merged offers it first.
Take a session out of a group from its card, or from the group's list with-, and it stays out.
A session in no group that looks like it belongs to one says which on its card, with join beside move to group.
Changed
- A group counts only the sessions on the map.
Board rows and cards name the members and leave out sessions the map hides, such as scripted runs and deleted transcripts.
A group with fewer than two sessions on the map is no longer shown.
Fixed
- A city started with
--homeleaves your own daemon alone.
It showed your own daemon's sessions, searched through it, and could restart it from the settings, and packing up, closing up or demolishing a session there could mark a real session, or one that does not exist, in your depot.
Without a--socketof its own, it now reads only the home it was given, and refuses to pack, close up or restart, saying why. find,bar --watch,notifyand the live session table under--homeread that home, not your own daemon.
Without a--socketthey showed your real sessions; they now read the home they were given, andevents, whose log lives only in a daemon, says to pass--socket.- The city no longer grows by several MiB at its second nightfall.
Redrawing the whole standing city, as it does when the light changes, now takes about a sixth of the draw calls, so the graphics library keeps less memory and the frame costs less. botropolis rmremoves a session Claude Code has already dropped.
Since Claude Code 2.1.310, stopping a background session removes its job, andrmthen failed with No job matching and left the building standing.
Now it forgets the session anyway, from the CLI, the card andstatus --live, and says Claude Code had already dropped it.
Any other failure from Claude Code still stops the remove.
v0.3.5
Changed
- What drives a road says what kind of traffic it is.
A car is still a session working in both projects right now, and a van still one message.
A box truck is now one file a session edited in the other project, and a motorbike one subagent it sent to work there.
Point at one, or press?, to read which. - Messages between members of a group drive the road as vans.
In 0.3.4 they ran as red carriages straight along the group's line, over the city with no track under them, and looked like the freight trains that mean a model's spend.
A group's line now carries nothing; it only marks who is grouped.
Fixed
- A session stopped on a permission prompt needs you.
A background session waiting for you to approve a tool read as working, for as long as it waited.
It now raises the needs-you beacon, andbotropolis barandstatussay so, until you answer it. - Right after the daemon restarts, statistics stay on.
Starting while the stopping daemon still wrote, it could find the database locked and report statistics are off: database is locked.
It now waits for the lock, and says statistics are off only when the database cannot be opened. - A thing first seen while a panel covers the city is captioned once the panel closes.
Before, its one caption was drawn under the panel's dim, where nobody could read it, and never came again. - A boat passing under the second bridge is drawn in front of the deck where it sticks out in front, and behind it where it sticks out behind.
The usage liner is longer than the deck is wide, and it used to be drawn either all in front of the bridge or all behind it, so a pier could cover its bow or its stern could cover the road. - The sea reaches the edge of the window wherever you look.
Panned or zoomed far enough from the island, a corner of the window showed black where the drawn sea ended; the website's hero video showed it too.
Past its edge the ground is now the sea's own colour, by day and by night.
v0.3.4
Added
- A
lightsetting starts the city in night or day, held whatever the clock says, asnholds it.
live, the default, follows the clock as before.
Set it for one run with--set light=night. - The city has a tray icon, and closing the window can send it there.
While the city runs, its icon sits in your desktop's tray: on KDE, Waybar or GNOME with its AppIndicator extension, and on i3bar or polybar.
Click it to open the city; its menu offers Open the city and Quit…, which shows the window and asks asqdoes.
With closing the window set totray, closing the window hides the city there, where it keeps running, instead of asking; in 0.3.3 it always asked.
Where no tray is found, it still asks, and the settings panel says why.
Changed
- The clinic's windows light up at night, as the library's and City Hall's do.
In 0.3.3 it stood dark after nightfall. - The truck taking a packed session to the depot drives at road speed.
It used to cross the city in two seconds, so fast it was easy to miss.
It now drives as fast as the city's other trucks, so a far depot takes longer, between two and six seconds.
Under reduced motion it is still a short cross-fade. - Zoomed far out, the floors of quiet districts no longer show cracks.
Below a quarter zoom they were specks a few pixels long, and drawing them slowed every frame; zoom in and they are there as before.
Fixed
- A city of hundreds of projects opens with half the work and less memory.
On a history of 600 projects, the city spends about half the CPU it did before its first map, and its memory at the start peaks about a quarter lower.
A city opened with--headlessno longer draws the loading panel, which no one can see. con a district now opens the new session in a terminal, once Claude Code has started it, instead of only raising a building.
The few seconds before it opens are Claude Code starting the session; the city's own part of the hand-off takes milliseconds.- Exiting a session opened from the city no longer asks whether to trust your home folder.
Every terminal the city opens on a session now starts in that session's folder.
When you exit, Claude Code shows its agent view in that terminal, and that view now opens in a folder it already trusts.
The terminal stays open with the agent view rather than closing, because Claude Code has no setting to turn that off.
v0.3.3
Added
- Several districts can be moved at once.
HoldCtrl(Cmdon a Mac) and click districts to select them, or drag a box over open ground to select every district it touches; each selected district is outlined.
Drag any one of them and they all move together, keeping their places relative to each other, and the city remembers where they went.
A move that would land one on another district is refused for all of them, andEscclears the selection. - A clinic on the plaza shows who needs you.
The building with the green cross that used to be City Hall now stands in the plaza's fourth corner as the clinic.
Its plate counts the sessions waiting on you plus the ones in trouble.
A session is in trouble when its last reply was an error from the API, when it stopped mid-turn in the last day because it crashed or its terminal was closed, or when its last three tool calls or more failed.
Interrupting a turn yourself does not count.
Click it, or pressa, for the list: the sessions needing you first, longest waiting at the top, then the troubled ones, each with its reason.
1to9jumps straight to a session, and↑↓withenterreaches the rest. - Drag with the right or middle (wheel) button to pan the map from anywhere.
A left drag that starts on a district picks the district up, which made panning a crowded city a chore.
A right or middle drag always pans, whether it starts on a district or a building, and never moves anything.
Shift+drag still pans too.
The help now notes that Alt+drag may not reach the city, because some window managers, i3 among them, use Alt+drag to move windows. - You can make a new group from any session's card.
Move to group now starts with new group…: choose it, type a name and press enter, and the session moves into a new group by that name.
The card offers move to group even before you have any groups, so your first group can be made the same way.
A name that is empty or already a group's is refused in the picker, and esc goes back to the list. - The City Plan zooms.
The wheel, or+and-, zooms the plan about the pointer, up to eight times closer, and a drag moves round it, so a crowded plan can be read district by district.
Zoomed in, a crowded plan's small badges grow back to full ones, and districts off the window leave their badges off it.
Wheeling in used to leave the plan at once; now a notch in after a pause at the plan's closest zoom returns to the map. - Shown scripted runs are street stalls.
With scripted runs shown, a session a program started, such asclaude -por the Agent SDK, is no longer a full building: it is a hot-dog cart, a market stall, a coffee kiosk or a food trailer, as its district's type, and opens the same card.
Its subagents at work queue at its counter as customers, one each, where a building's fly over it as drones. - Closing the window asks before the city quits.
The window's close button, or your window manager's kill (mod+shift+qon i3), used to end the city at once.
Now it opens the quit panel, asqdoes, so you can quit, close up, or cancel.
A new setting, closing the window (on_closein the config), chooses betweenask, the default, andtray, which will hide the city in your desktop's tray, where it keeps running.
The tray icon itself comes in a later release, so for nowtrayasks too, and the settings panel says why.
Changed
- City Hall looks like a town hall.
It was drawn as a building with a green cross on its side, which is a clinic's sign.
It is now a stone hall with a six-column portico, a pediment over its steps and a clock tower whose face shows from every side. - A session in a temporary directory joins the district its work is tied to.
Since 0.3.2 every session in/tmp,$TMPDIRor another temporary directory stands in one Temporary district.
Now one whose transcript ties it to a project on the map stands in that project's district instead: Claude Code's scratchpad for the project, a team or a lead it works with, subagents that worked in its folder, a message either way, or files it edited there.
Its spend counts there too, in the power plant's breakdown and the statistics ranges, so each district's figures add up to the buildings drawn in it.
A session whose transcript is gone has no tie left to follow, so its spend counts under Temporary. - Quitting asks in the middle of the window, not in the footer.
qopens a small panel over the dimmed city with three buttons: Quit (yor Enter), Close up… (c) and Cancel (n, Esc, orqagain).
It stays until you answer it, rather than going away on its own after ten seconds, and while it is up the map behind it takes no other key or click. - The city does less work each frame and holds its memory down.
A city whose buildings are standing still now reuses what it drew last frame instead of working each building out again, so a quiet city costs less of a core, at fit and zoomed in.
Zoomed in, a frame no longer does work for every building in the city, only for those on screen; the minimap is painted once rather than every frame, and the buildings are put in drawing order without being sorted afresh every frame.
The city now keeps the memory Go uses to about 300 MiB, unlessGOMEMLIMITis set in its environment; on a staged city of 2,400 sessions in about 600 districts, the map now opens in about 4 seconds where 0.3.2 took about 6, the city settles at under 500 MiB, and the memory cap costs no frame time.
Fixed
- Letting go of the map after dragging it no longer selects what is under the pointer.
A drag that began on a building used to end as a click on it. - The wheel zooms out all the way to Skyline on any city.
On a big city, or a small window, zooming out used to stop short of the whole-city view, so the only way to Skyline wasf, and the City Plan could not be reached with the wheel at all.
The wheel now always reaches Skyline, and a notch out after a pause there opens the plan. - A group's line no longer stops at one station and leads nowhere.
A group draws its line only when it runs through two districts or more on the map.
A group whose sessions are all in one district, or whose others are hidden, scripted or packed up, shows its badge on its buildings and no line, and keeps its stand-up and its details.
Packed-up sessions no longer pull a line out to the depot. - Copying a path or a line no longer freezes the city when the clipboard tool is xclip or xsel.
The whole map used to stop for good, with no frames, no input and no way to quit, because the city waited on a helper the clipboard tool leaves running.
A copy now runs beside the map, and a clipboard tool that has not finished within two seconds is stopped, with a notice saying why.
Revealing a folder and opening a pull request run beside the map too.
Tools the city starts no longer inherit its open files, such as its input devices. - Resume, New, Fork, Stop, Remove, Restore and Close up no longer freeze the city while claude runs.
Each used to stop the whole map until claude answered, and a claude that stalled on the network, or a session that kept its output open, stopped it for good.
They now run beside the map, and the footer says what each is doing, such as resuming Fix the queue…, until the building changes or a failure replaces it.
A claude that has not answered within its time, two minutes to start or resume a session and thirty seconds to stop or remove one, is stopped, with a notice saying which.
Pressing the same action again while it runs says it already is, rather than starting a second claude.
Close up keeps its panel open while it works and quits once it is done. - New session takes typing.
Its directory, prompt and group fields ignored the keyboard, and took text only from a--keysscript.
They now take typing and input methods the way the finder does. - Every text field takes a paste.
Ctrl+V(Cmd+Von a Mac), orShift+Inserton Linux, pastes into the finder, New session's directory, prompt and group name, a new group's name and triage's snooze, at the caret.
A paste of several lines becomes one, and a trailing newline is dropped.
The clipboard is read with the tool copying uses,wl-paste,xclip,xselorpbpaste, beside the map and for at most two seconds, so a tool that hangs shows a notice and never freezes the city.
With none installed, the notice says what to install. - The card's pack button packs the session up again.
Pressing pack on a building's card, or unpack on a crate's, did nothing, so a boarded-up building stayed where it stood.
Both now take the session to the depot and back, as Shift+P always did, and the footer says which.
A session still working comes back from the depot as soon as it does something, and packing one now says so. - Closing up quits the city.
Enter in the Close up panel noted what was open and paused what you chose, then left the city running, with only the panel closed.
Now it quits once both are done, as the quit prompt's quit does, and so does Shift+Q when nothing is open.
If the note cannot be kept or a session cannot be paused, the panel stays open, says which, and nothing quits. - A session's card stays one size as the pointer moves over its buttons.
It used to grow when the pointer reached a button, to fit what that button does, and shrink again when it left, so the card flickered.
Now it keeps room for the longest description among its buttons, wrapped to the card's width, and only the words in that space change.
v0.3.2
Changed
- The daemon uses about a third less CPU on a home with thousands of sessions.
With 2,000 sessions and one of them working, it settles at about 1.7% of a core, inside its 2% budget, where it used 2.5–3%.
A session's reply still reaches the map within about 1.6 seconds, and a hook still changes its building at once. - Scripted runs are no longer drawn as buildings.
A session a program started, such asclaude -por the Agent SDK, used to stand as a building like one someone works in, so a machine that runs Claude from scripts filled with them.
They are off the map and out of the finder by default, and their tokens and spend still count in the power plant, the strip and the statistics.
The settings panel's scripted runs row, orscripted_runs = "shown", brings them back at once.
Fixed
- The package builds for anyone who has changed a setting.
0.3.1 failed to build from source, the AUR package included, when the person building it had setdistrict_typeor any of several other keys in their own config or environment, because a test read them.
The tests now never read the builder's config, and every test run checks that against a config that changes every setting. - A statistics store the daemon cannot open no longer turns statistics off without a word.
The daemon logs why, naming the file, andbotropolis doctorhas a statistics row that warns with the reason.
The city shows a notice once per launch with what to do: update Botropolis for a store written by a newer release, or move a damaged one aside and restart the daemon.
A damaged store is refused and left exactly as it was, never repaired or reset. - The city behind a notice or a dimmed panel no longer reacts to the pointer.
Resting the pointer on a notice, the board, the settings or any other panel that dims the map used to raise the card of whatever stood behind it.
While the map is dimmed, nothing on it is hovered. - A session whose transcript Claude Code deleted leaves the map.
On a machine with a long history, every such session used to stay drawn, however old, and each could be a district of its own.
Its statistics are kept, so the power plant, the strip and the statistics panel read as before.
The settings panel's deleted transcripts row, orgone_sessions = true, brings them back at once. - Sessions started one after another no longer chain into groups of hundreds.
Starting within a minute of another session no longer joins it to a group on its own; it is suggested instead.
Timing still counts alongside other evidence, such as shared files or a branch, but it never links one session to the next down a stream of runs.
A group holds at most 40 sessions, and the daemon logs any it leaves out.
A ticket, team, branch or file shared by more than 40 sessions no longer groups any of them, and the daemon logs it; on a long history this also takes most of the work out of the first load.
New session now says perhaps rather than likely when its only reason is that you were in one of the group's sessions a minute ago. - A city with hundreds of districts opens and stays usable.
On a long history the map used to freeze, and quitting withqthenycould fail while it was busy.
A city of 900 districts and 2,400 sessions now draws a frame in about 40 ms where it took 120, and in about 17 ms zoomed in, and lays itself out in under a second where it took 3.4 seconds.
The quit prompt now waits for your answer however busy the city is. - Sessions in temporary directories share one district, Temporary.
A session started under/tmp,/var/tmp,$TMPDIRor macOS's temporary folders used to be a district of its own, so a machine with a long history could fill with hundreds of one-building districts.
They now stand together in one district named Temporary.
A directory that only hastmpin its name, such as~/tmp-project, is still its own district.
v0.3.1
Added
- The global shortcut works on macOS.
Set in the settings panel, it opens the finder from any application and brings the city's window forward, with no Accessibility permission to grant.
macOS will not take a combination whose only modifiers are Option and Shift, so the row refuses one in words and keeps what was set. - A large island gets a second bridge.
Once the island holds 16 districts, a second bridge leaves by the east coast, crossing the river on a raised deck, and fades into its own fog out at sea.
Over the river the deck rises from each bank high enough for the tallest boat, the weekly-usage liner, to pass under it, as gently as the first bridge's ramp, and comes back down before the open sea.
It stays where it was placed as the island grows, and across a restart, even if the island later holds fewer districts.
Each delivery truck takes whichever bridge is nearer its building by road.
The east railway moves out one cell when the second bridge arrives, so the bridge road climbs before it crosses the rail, as it does on the west.
Changed
- A still city spends less time drawing each frame.
A building, a worn or overgrown lot, a tree, a district's sign or monument, a piece of a bridge or the fog it fades into is no longer drawn again every frame only to come out the same: it keeps last frame's drawing, its lit windows at night included, until something it is drawn from changes, and a sixteenth of what is kept is drawn again each frame to check. - The city holds about 38 MiB less graphics memory fully zoomed in, and 12 MiB less at every zoom.
The island's shore is painted coarser as the island grows, so its texture stays 1024 pixels a side, and the closest zoom draws a new middle level of the kit art in place of the largest one. statusnames models short, as the city does.
The MODEL column readshaiku-4-5rather thanclaude-haiku-4-5-20251001, so one model no longer widens every row;status --jsonstill gives the full id.
The power breakdown's model mix drops the date too.- The strip's MCP chip says it counts calls, as "6 mcp calls", so it no longer reads as six servers beside a map of two radio towers.
- The help lists
fand0on one row, "f or 0: Skyline, the whole city", since both do the same thing. - Zoomed out, buildings and vehicles are drawn sharper.
Below half size they are drawn from their full-size pictures rather than smaller, softened copies, so rooftop details and trim stay crisp, and the night's lit windows still end exactly at each building's edge. - The bridge runs off into the haze.
The deck no longer stops in open water: it runs on a few cells past where it ended and fades into the sea, and a delivery truck fades with it and is gone at the far end. - The bridge fades into fog.
A still bank of fog stands where the deck fades, with a thin mist along that coast, so the deck and its trucks vanish into something, by day and by night.
Removed
- The three 16 px Kenney tile packs, Tiny Town, Tiny Factory and Roguelike Modern City, which only the retired top-down view drew.
The install is smaller, the city no longer loads them at startup, and the packages no longer shipkenney-packs.md; the 3D kits' credits stay inkenney-kits.md.
Fixed
- A session whose turn ended over its own background command no longer says it needs you.
While Claude Code says the session is running a shell command, it is working, with no beacon and no change of colour inbar, until the command finishes and the turn is truly back with you.
A permission prompt still needs you. - An agent team's messages travel the road between its districts.
Recent Claude Code versions name a team after neither of its sessions and mark only the teammates as in it, so a lead's messages to its teammates were never road traffic, and a teammate's messages to its lead stopped counting once the lead ended.
The city now knows a lead by the teammates it starts, and still reads teams named after their lead from older versions. - The power breakdown no longer prices unknown messages at $0.00.
A row none of whose messages has a known price, such as a model the price list does not have yet, says "cost unknown", as the panel's title already does, rather than "$0.00". - The day's spend is whole as soon as the city has read your history.
Right after its first read the city could show part of the day's spend, and part of each session's cost, for up to 30 seconds; it now shows all of it once the read is done. - Cars, vans and trucks keep their wheels on the road.
Zoomed in, the inspector's car could park on the kerb outside a lot, cars cut across the kerb on every bend, and the site trucks and delivery truck clipped the kerb or a building as they turned in a lot. Every vehicle now drives its lane round the curve of each bend, and keeps to the lot's floor inside a lot. - A finder row that is too long for the panel ends with "…", as the card and the sidebar do, rather than stopping mid-word at the edge.
- The railway no longer shows through the trees.
Where the freight loop runs behind a tree, the tree now hides it; the trees look as they did over the grass. - A building looks the same at every zoom, however often it is drawn.
At some zooms, a building drawn again from what the city remembered of it could show its sign's letters or a boarded window's planks a pixel off from how it was first drawn; once it is wholly on screen it now matches exactly. - A boarded-up building's planks hold still while the map pans.
On some factories zoomed out, a square window's planks could change shape from one frame to the next as the camera moved; they now stay as they are. - A road leads to every bridge.
Each bridge's ramp came down onto grass, a block from the nearest road; now a road runs to it out of the nearest lot and meets the ramp in a T, and stays where it is as other roads come and go.
Where a road between districts ends short of it, a short joining road links the two, and fades when that road does.
A delivery truck keeps to the road where it goes, and crosses unpaved ground only to reach it.
The road to the bridge has no street lamps yet. - A delivery truck always leaves on the bridge.
When the island grew while a truck was on its way, the bridge moved and the truck carried on where it had been, beside the deck and over the water; it now takes the bridge as it stands. - Message vans and the depot's trucks arrive where things now are.
When the city was laid out again during a trip, a message van kept to a road that had moved, and a truck carrying a crate drove to where the crate's place in the depot had been.
The van now carries on from where it is along the streets as they stand, and the truck turns toward the crate's new place, neither jumping nor speeding up. - The bridge stays where it is.
It moved over a row every time the island grew a row; it now keeps its place beside the same blocks as the island grows and across a restart, and moves only when its road does.
v0.3.0
0.3.0 is a performance release.
Measured on a laptop's integrated graphics (Intel Core Ultra 7 265U) with a real history of about 200 sessions in 150 projects, against 0.2.2 and the first builds of this release, measured the same week:
| before | 0.3.0 | |
|---|---|---|
| drawing a frame, focused | 17–48 ms | about 10–11 ms |
| the city's memory, settled (own and GPU) | 715–817 MiB (4.6 GiB in 0.2.2) | about 445 MiB, 565 fully zoomed in |
| the city's heap in its first seconds | up to 3.1 GB | about 400 MB |
| a hidden city | 7.9% of a core and 462 MiB | under 1% and under 200 MiB |
| the daemon, settled | up to 24% of a core, in bursts of several cores | under 1% |
| the first launch | up to four cores, about 9 s to a map | under one core, a map in about a second |
Some budgets are still missed, and 0.3.x continues on them: a focused city uses about half a core where the budget is a tenth, and fully zoomed in it holds about 55 MiB more than its 512.
Before you upgrade:
- Restart the daemon after installing (
botropolis setup, or the city's Restart Daemon dialog): a 0.3.0 city and daemon talk a new version of their protocol, and a city meeting an older daemon says so and offers to restart it. - Some commands moved, and the old names still work through 0.x with a note on stderr:
tuiisstatus --live,resumeisattach,pruneisrm --older-than,install-hooksissetup, and per-setting flags such as--daily_budget_usdare--set daily_budget_usd=5. usage_refreshis at least 15 minutes: a config asking for less is read as15m.- Release builds no longer have the city's filming flags (
--screenshot,--recordand the rest);pstill saves a picture, and sharing mode records GIFs and clips.
Added
-
docs/compatibility.md says what 1.0.0 promises not to break, and
make version-checknow fails when any of it is removed without an entry here under Removed and, from 1.0.0 on, a new major version:
every command and flag--helpshows,status --json's documented keys,bar's JSON, every config key and its named values, every data file an earlier version wrote, and the package, release, unit and hook names. -
Manual pages:
man botropolis, a page per command such asman botropolis-attach,man botropolisd,man botropolis-hook, andman botropolis-configfor every config key with its default and environment variable.
The deb, rpm, Arch package and Homebrew formula install them, andmake manbuilds them. -
Sharing mode, for posting your city:
shift+sin the city hides what identifies you (session titles, project and district names, prompts, spend and token figures, and every panel that shows them), thenpsaves a picture,ga four-second GIF at 1080p and 30 frames a second, andca clip of 5 to 60 seconds (lpicks), to your Pictures and Videos folders.
The city wears neutral names while it is shared, such as District A and Session 3, andescbrings everything back as it was.
A clip needs ffmpeg, which the deb and rpm suggest; the city says so when it is missing. -
The reading pane (
o) shows Claude's replies as formatted text, not raw Markdown.
Bold is bold, code and tables are set in Go Mono on a faint tint, a table with its columns lined up and its header in bold, lists have bullets and indent as they nest, quotes are indented, paragraphs have room between them, and a link shows its URL after its text.
Your prompts and tool calls are shown as typed, and HTML in a reply is shown as text, never run.
Changed
-
A frame of a large city takes a tenth of the drawing it did, and about half the memory.
Lines, lots, scaffolding, beacons, wires and glows are drawn as small meshes with a soft one-pixel edge instead of anti-aliased paths.
On the metropolis demo that is about 75,000 indices a frame instead of 766,000, and a live heap of about 125 MB instead of 255 MB.
Filled shapes read about half a pixel larger at their edges, and two of one colour that meet leave no seam between them. -
A still city is drawn once and kept; only what moves is drawn again.
The ground, every building, tree, lamp, landmark and sign, the group lines and the map's names are put together once and reused until something in them changes, and the cars, drones, boats, trains and the rest are drawn again each frame only where they are, passing in front of and behind buildings as before.
Panning with the arrow keys moves the picture and draws only the edge it uncovers.
On the metropolis demo a settled frame is about 22 draw commands and 4,900 indices instead of 135 and 34,000, a pan about 29 instead of 138, and the city holds about 30 MB more of pictures at 1600×900.
A scaffold's lamps, braces and hoist no longer swap corners as the map pans. -
A still building is drawn as one picture instead of a dozen pieces.
Each building's walls, windows, sign, flags, scaffold and spire are put together once and reused every frame until its look changes; what moves, such as a pulsing beacon, smoke or a hoist's loads, is still drawn each frame on top.
On the metropolis demo a settled frame is about 135 draw commands instead of 280, and the pictures take a third of a megabyte at the opening zoom and about 2 MB up close, within a 32 MB cap.
A building's own sign, scaffold and spire now hide its lit windows behind them at night. -
Zoomed all the way in on a large history, the city draws a frame in about half the time it did, with about half the CPU.
Buildings off the screen are no longer drawn at all, and those on it stay drawn as one picture each instead of being redrawn piece by piece once the city had more of them than it kept.
The journal, the group review, the top strip, the event stream and the timeline are redrawn only when what they show changes, not every frame. -
The city holds less in memory, most of all zoomed in.
Zooming in and back out no longer leaves the city holding pictures of buildings it has stopped drawing, the sprites load in smaller pieces, are packed onto fewer and smaller pages and sit in less memory, the picture kept for panning is let go once you stop, and the coast has its own texture rather than growing a shared one: about 135 MiB less at full zoom on a large history than early in this release, which is still about 55 MiB over the 512 MiB budget there. -
An unfocused city keeps up, as a dashboard on another monitor.
It used to show the last frame it drew while it had the focus; it now draws again whenever something changes, such as a session starting, stopping or needing you, and nothing moves in between, so it costs little while it sits there. -
A city you cannot see costs far less while sessions work.
An update from the daemon is now laid out in milliseconds rather than more than a second on a history of a few hundred sessions, and is laid out at all only when it changes the map.
A hidden or minimised city lays out nothing until you bring it back, and its window title still says at once that a session needs you; on 200 sessions it went from about 6% of a core to under 1%. -
The daemon sends the city only what changed.
A city used to be sent the whole picture of every session on every update, about 260 KB a second while 200 sessions worked; it now gets the whole picture once and then only the changes, about half a kilobyte a second.
An unfocused city decoding and laying out those updates spends under 1% of a core on it.
A city and a daemon must still be the same version. -
A city left open on another monitor costs about a thirtieth of what it did while your projects share work.
Every update from the daemon used to lay out every street between projects again, which on 200 sessions in 150 projects with 80 streets between them took about a quarter of a second, and kept an unfocused city at over a fifth of a core while one session worked.
The city now lays out a street again only when the plan, the camera's heading or the projects it joins change, and an update that moves only what sessions are doing takes a few milliseconds: under 1% of a core. -
A city on another monitor draws each change for a third of the CPU it did.
The cracks and wear on long-quiet lots are worked out once rather than every frame, and the ground under the city is no longer redrawn for an update that changes nothing on it.
On a real history of about 200 sessions with two working, drawing fell from about 1% of a core to 0.3%. -
With statistics on, a city left open while sessions work no longer spends a sixth of a core reading your costs.
Its 24 h cost was read from the statistics store every 2 seconds, and each building's every 30, which on a history of 30,000 messages kept the city at about 16% of a core; it now stays under 1%.
The store keeps a note of what each write changed, so the city reads again only those messages and prices again only those sessions, rather than reading the whole day and every session's history.
The 24 h cost is brought up to date at most every 30 s while sessions work, and every 5 minutes when nothing changes, so it can lag by up to 30 s (or 5 minutes for messages leaving the 24 h window); a building's cost is brought up to date only when something was written. -
The command line is smaller: 13 commands in four groups, and four global flags.
botropolis --helpgroups the commands as sessions, the city, setting up and checking, and those other programs run.
attachattaches in the terminal you are in, and opens one only when run from elsewhere or with--new-window; given a resting session it resumes it first, so a plainclaudeno longer drops toclaude attach.
rmtakes several ids, or--older-thanfor every resting session quiet that long.
status --liveis the live table.
setupregisters the hooks, starts the daemon with systemd or Homebrew and says exactly what it ran...