Skip to content

v0.3.3

Choose a tag to compare

@github-actions github-actions released this 27 Oct 17:27
56796db

Added

  • Several districts can be moved at once.
    Hold Ctrl (Cmd on 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, and Esc clears 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 press a, for the list: the sessions needing you first, longest waiting at the top, then the troubled ones, each with its reason.
    1 to 9 jumps straight to a session, and ↑ ↓ with enter reaches 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 as claude -p or 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+q on i3), used to end the city at once.
    Now it opens the quit panel, as q does, so you can quit, close up, or cancel.
    A new setting, closing the window (on_close in the config), chooses between ask, the default, and tray, 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 now tray asks 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, $TMPDIR or 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.
    q opens a small panel over the dimmed city with three buttons: Quit (y or Enter), Close up… (c) and Cancel (n, Esc, or q again).
    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, unless GOMEMLIMIT is 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 was f, 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 --keys script.
    They now take typing and input methods the way the finder does.
  • Every text field takes a paste.
    Ctrl+V (Cmd+V on a Mac), or Shift+Insert on 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, xsel or pbpaste, 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.