shtukbase

Releases

Every version, newest first, with what changed and its download for Mac.

0.5.3

Download for Mac80 MB · macOS 14 or later

0.5.3 is the glass release. The left sidebar can be a real pane over the desktop, with a colour and a shape you choose; the dark appearance is finished; dictation stands where it should and answers at once.

The left sidebar

  1. Glass, made by the system. The sidebar asks macOS for its material and stands over it: the desktop, blurred, with the pane's own light and edge. It is the same material Apple's own sidebars use, not a painted imitation.
  2. One material, shaped by you. Settings › Layout has a Sidebar section: Solid or Glass, a palette of five dark tints (black, graphite, slate, cocoa, forest) and five pale ones (paper, ivory, mist, fog, linen), a colour you can type, and sliders for colour strength, blur, transparency and matte.
  3. The pane follows the sliders while you drag them. Nothing is saved until you let go; the window keeps the look for the next start.
  4. A row's controls sit on the row. The small plus, the menu and the fold arrows take their ground from the lane they stand on, so they are never a plate of another colour and never vanish under the pointer.
  5. The kind is a mark, not a word. A board, a collection or a web page says what it is with the corner of its mark; the type word is gone from the row.

The dark appearance

  1. No pure black. Menus take the app's own dark grounds.
  2. Marks read in both appearances. The floating canvas controls draw from colour roles with a light and a dark value, so an armed tool is never a white plate with a white mark.
  3. The folded sidebar draws the frame. With the lane folded away there is no see-through hole in the window's top-left corner.
  4. A chosen row's mark keeps its ink. It reads with the chosen name instead of fading into the wash.

Dictation

  1. The indicator wraps the camera cutout. It stands at the screen's top edge in every state, and its hover is judged on where the window actually is.
  2. It goes away when the words are delivered. The pill closes when recognition ends, and the next hold opens a new one.
  3. Recognition starts at once. The model is warmed when the window opens, so the first hold does not wait for it, and the pill's timer keeps the recorded length while the recogniser works.

The window

  1. Closing the window ends the app. The red button stops everything, including the development loop.
  2. One window per profile. A second copy leaves on its own instead of fighting the first for the shortcuts and the local node.
  3. The window is signed. Shtukbase ships as a notarized Developer ID application; the microphone and the dictation shortcuts keep their grants across updates.

0.3.4

Download for Mac355 MB · macOS 14 or later

0.3.4 is the first release since 0.3.2. Each chat now has one agent, and the composer has one tidy row. Local models answer on this computer. Boards get a new canvas, and the window comes back where you left it.

Chats and agents

  1. One agent per chat. Profiles are gone. An agent's own page holds the setup its chat starts with: mode, models and reasoning. Reset and Save to agent sit beside a chat that has changed.
  2. The composer is one short row. Plus and access stand on the left. On the right is one seat: the agent's face and name, the model in grey and the reasoning bars.
  3. A narrow composer stays readable. The agent's name never shrinks. The model's name gives way first, and at the narrowest width only the marks remain.
  4. Dictation is one microphone in the composer. What you say goes straight into the message you are writing.
  5. A chat with no model offers to connect one. It no longer says Try again when nothing can answer.

Models on this computer

  1. Ollama answers here. Choosing Ollama answers with a model on this computer. If Ollama is not running, or the model is not there yet, one plain sentence says so and where to fix it.
  2. The built-in Bonsai model works end to end. Choosing it switches the chat to it. It reads its plain name, holds a longer conversation, and starts again by itself when you send the next message.
  3. A local chat stays local. A chat's title is written by its own model, so your words never leave the computer for a name.

First run

  1. The first screen explains itself. It says what each provider is, what a key is, and that leaving is fine.
  2. A refused key is not kept. The connect step comes back until something answers.
  3. You land in your own project. A new space opens on your project, with an empty front page.

Boards

  1. A new canvas. Notes are flat with a soft shadow. Arrows are thick with their words in the middle. A grid, frames and a map of pages join them.
  2. Arrows land where they should. An arrow's end meets the side that faces its source, and it stays there when you move things.
  3. Page cards stay live. A card wears the gallery's look, and its page opens beside the board.
  4. Fitting a board keeps every item in view. Nothing hides behind the tools or the zoom controls.

Panels and pages

  1. The side panel keeps tabs. Pages you send there stay as tabs in its top row, and you can drag them.
  2. Pages gain Fullscreen and Copy file link. In the desktop app a page's menu in the sidebar also copies its file location and shows it in Finder.
  3. Lists keep their columns. A grouped list keeps its columns lined up under a sticky header, and a row stays one line at every width.

Speed and the window

  1. The app opens and switches faster. Chats stay ready, pages load after the window opens, and changes on disk are heard sooner.
  2. The window comes back where it was. After Quit, it reopens in its old place and size.

What is fixed

  1. The app stops fully. Its background work ends when the window is gone, even after a force quit or a crash.
  2. Tabs return without errors. A restored chat tab waits for its space, and an empty chat tab is not brought back.
  3. The sidebar remembers folded rows. A folded branch stays folded after a restart.

0.3.2

Download for Mac366 MB · macOS 14 or later

0.3.2 is 0.3.1 with everything the other work streams had already finished. 0.3.1 was cut from an older checkout and left these out, so install this one instead.

What is fixed

  1. Quitting no longer crashes. Command-Q used to end with a crash report from the local speech engine. The app stops its own work and exits cleanly.
  2. A web page fills its panel. A page opened in the side or centre panel uses the room the panel has, and the side panel never takes more than nine tenths of the window.
  3. The sidebar draws every row the same way. A row with no icon keeps the room an icon would have, so a name never sits a step to the left of its parent, and nothing appears when you point at it.
  4. The chat you open is the chat you read. Opening one reads only its own messages, its row is marked in the sidebar, and a chat of another space no longer stands in this space's list.
  5. A page stays where you put it. Opening a page no longer turns into a chat a few seconds later.

What is new

  1. The trail above a page is a set of doors. The collection above a page opens its table, and a folder opens a page that lists what is inside.
  2. A model that runs on this computer. The first screen offers it as one checked row, and Provider shows its progress. It is pinned and checked before it is used, runs on this Mac only, and is drawn as Local model in words.
  3. Web pages keep their fields. A web page's own fields are kept, and its tabs stay when you reopen it.

0.3.1

Download for Mac364 MB · macOS 14 or later

0.3.1 fixes how the app quits and how it opens, and carries the work done since 0.3.0: one setup menu for every chat, web pages in your Pages list, and routines that keep one chat.

What is fixed

  1. Quitting no longer crashes. Pressing Command-Q used to end with a crash report from the local speech engine. The app now stops its own work and exits cleanly.
  2. Opening a second copy brings the first forward. Two builds installed side by side used to start two copies on one space. Now the second launch shows the copy that is already running.

What is new

  1. One setup menu under the composer. It shows the profile, colleague, mode, model and reasoning level. Its lists scroll inside the window, and Reasoning offers the levels of the model you chose.
  2. Web pages stand in Pages. They sit in the tree beside written pages. A Markdown link to an HTML file opens it as a page, and an open page reloads when its file changes.
  3. A routine keeps one chat. Every run writes into it, and it shows in every build. A routine can wake many times a day.
  4. Computers. A project can be sent to a computer you rent, a routine can be allowed there, and its runs are read here. The link between the two carries the computer's own chat.
  5. Standard menus. A right press opens the same context menu everywhere, and a second press on the control that opened a menu closes it.
  6. Room between panels is your choice. Appearance offers Thin or Wide space between panels.

0.3.0-sep2900

Download for Mac373 MB · macOS 14 or later

A rebuild of 0.3.0 that adds a model you can run on this computer.

The local model

  1. The first screen offers it. A checked row, Download a local model, stands under the key field on the first run, and it is drawn only when this Mac can run it. Leaving it checked and pressing Start opens your space at once: the download runs in the background.
  2. The Provider menu shows it. Chat → Assistant menu → Provider → On this computer: Download a local model, then progress with Cancel, then Ready — one press uses it in that chat. Failures read as one plain sentence each, with Try again.
  3. The model is pinned and checked. One published release and one weight file, each pinned by digest. The download resumes where it stopped, is checked against those digests, and is only then unpacked and published as usable — a half-finished download is never shown as Ready.
  4. It runs on this computer only. The program that runs the model listens on this Mac alone, on a port chosen when it starts, and answers only a request carrying the token minted for that run. It stops when Shtukbase quits.
  5. Which Macs. Apple Silicon, macOS 14 or newer, and at least 24 GB of memory.

The app itself is unchanged otherwise, apart from the fixes this rebuild carries.

0.3.0-sep2801

Download for Mac364 MB · macOS 14 or later

A rebuild of 0.3.0 that makes computers you rent work end to end.

Computers

  1. Adding a computer asks clearly. When it first connects, the step stops and asks you to check the computer's key, instead of spinning.
  2. Adding a computer finishes. Shtukbase sends a signed copy of itself to the computer, installs it and starts it, even on a connection that drops now and then.
  3. A computer's page shows how it is doing. Its version, how long it has been up, its load, its memory and disk, and the projects it holds.
  4. Your model keys reach the computer. When you agree, the keys you keep under Models are copied there, and a key you add later follows.
  5. A chat can run on a computer. Send a project there from its menu, then choose the computer under Runs on. The chat keeps going with the laptop closed.
  6. A routine can run on a computer. Allow it there, run it now or on a schedule — every 10, 15 or 30 minutes, or every hour — and it writes its results by itself.
  7. Each routine has one chat. Every run adds its question and its answer to the same chat, which opens from the routine's page.
  8. Project names in any alphabet work on a computer.

The app

  1. Only one copy of the app runs at a time. Opening another build while one is running brings the running window forward.

0.3.0

Download for Mac286 MB · macOS 14 or later

0.3.0 is the first release since 0.2.5, and the largest so far. Chats gain one setup menu, profiles you can share and more than one account per provider. A computer you rent can keep chats and automations working while the laptop is closed. Pages open on their pictures, one setting changes every icon, and the window, search and Settings are rebuilt.

Chats and colleagues

  1. The composer has one setup menu. It shows the profile, the colleague, the mode, the model and the reasoning level in one short column. Expand opens it as a large panel with a section for each.
  2. A profile is a chat setup you can reuse. It keeps a colleague, a mode and models in their order. Four starting profiles ship, and your own can be saved, renamed, duplicated and deleted.
  3. A profile can be shared as one file. The person who adds it gets the colleague's role and skills, never its memory, and the models run on their own accounts.
  4. The model picker keeps favourites and recent models. A starred model stays at the top.
  5. A chat moves to another account of the same provider in one press, and keeps its model. When an account runs out of room mid-chat, the chat moves to the account with the most left and says so once. You can choose to be asked instead.
  6. Full context shows the next message as one document. Every part is there with its text and size, so you can read exactly what a colleague receives.
  7. A colleague's question appears in the chat, and you answer it there.
  8. Subagents are shown as a tree. Each one says whether it is working, needs your answer or has finished, and opens its own chat.
  9. A chat is marked unread when its answer arrives while you are elsewhere.
  10. Archived chats can be found and restored from All chats. Archiving a chat closes its tab, and Undo brings it back.

Computers and automations

  1. A computer you rent can be added in Settings › Computers. The app installs itself there over a secure link, signed in with your own key.
  2. A chat can run on a computer. Runs on in the setup menu chooses where, and the chat's header says it. If the link drops mid-answer, the app keeps asking to rejoin until the computer is back.
  3. Each computer has its own page, where you can rename it or forget it.
  4. Accounts with a key are copied to a computer only once you agree. A key added later reaches every computer.
  5. When you come back, a card above the tabs counts what each computer finished and what needs you.
  6. An automation's page shows its runs, with a Run now button. Allowing it to run is one sheet.
  7. An automation can wake on a schedule. The editor asks for the days, the time and the zone in words, and shows the next three times it will run.

Pages, pictures and icons

  1. A page can open on its pictures. A tall cover leads, the pictures rise from it, and the page's mark sits on its edge.
  2. Many pictures arrange themselves in rows, a mosaic, a filmstrip or a band. Fill the space and a caption are one choice away.
  3. A page's pictures open in one viewer, and the gallery shows each picture whole. One control on the picture holds previous, the count and next.
  4. An empty picture page offers Add picture. A picture that cannot be read keeps its place calmly, and printing a page prints every picture.
  5. A page shows its properties as a short row of chips that you edit in place. Settings › Appearance can show them all instead.
  6. Keys typed while a new page is being made go into its name.
  7. One setting changes every icon in the app. Settings › Appearance › Icons offers four sets, and the choice reaches every surface at once.
  8. The icon picker is rebuilt with Emoji, Icon and Upload tabs and a filter. Emoji take a skin tone, icons take a colour, and Random picks one.

The window and the sidebar

  1. The page and the pane beside it are drawn as cards, and one Panels menu opens every pane a tab offers.
  2. Panes can sit at the bottom as well as on the right. A pane moves from its menu, and Changes is the first pane that lives at the bottom.
  3. The foot of the sidebar is one switcher for every project in every space. Typing narrows the list.
  4. A dot on a project's picture shows whether it has work to send or get, and Sync with GitHub opens a card with one clear button for each state.
  5. All chats lists the chats of every space, from a button in the sidebar or as a section of its own.
  6. The tab menu offers Close other tabs, Close tabs to the right, Copy link, Reopen closed tab and Change icon. Tabs are drawn as pills.
  7. F6 walks the window's parts, and the first Tab can skip straight to the page.
  8. Switching spaces shows an opening screen with the space's name, never a white window. Each project keeps its own tabs through a switch.
  9. If the part of the app that reads your files stops, it starts again, and the window says so while it waits.

Search and graphs

  1. Search finds chats by name. Before you type it offers recent pages, and each answer shows where it lives.
  2. Graphs are rebuilt from the ground up. A project of well over a thousand pages draws in about a quarter of a second, names stay readable, and the graph beside a page shows that page's own neighbourhood.

Tables and collections

  1. Filter opens on a searchable list of properties, with one condition per line.
  2. Numbers align right, and a word typed into a number cell is refused instead of clearing the cell.
  3. Enter picks the highlighted choice instead of making a new one from what was typed.
  4. A table inside a page fits the reading column. A collection table's header stays in step with its rows when it scrolls sideways.

Settings, the first run and dictation

  1. The first run asks one question: a key for your model provider. The key is checked before it is kept, and the screen opens only when nothing can answer yet.
  2. Models is one calm page. Adding a provider or a model opens a sheet, and removing one asks in its row.
  3. Any shortcut can be changed in Settings › Shortcuts, now one table. Your changes are kept in a file you own.
  4. Dictation has two shortcuts. One types while you speak, the other types once you stop, and the listening strip shows which one is on.

0.2.5

Download for Mac292 MB · macOS 14 or later

0.2.5 is a correction release for the first morning after 0.2.4: the tab strip, the chat's tabs and notices, and the sidebar's pins — with two keyboard chords for making things.

Tabs and the keyboard

  1. A tab closed with the keyboard no longer returns to the strip, and no longer comes back in the wrong position.
  2. Command-N makes a chat and Command-Shift-N makes a page.
  3. A tab opened for a new chat is selected when it is made, and the chat's title row names the route its model call runs on.

The chat

  1. A preview pressed in a chat opens the picture. The row that opens a file address answers again.
  2. A chat that is not on screen stays silent. A frame kept for a project the person left no longer raises a notice or opens the viewer over the pane the person is looking at.
  3. The model control can no longer refuse a send.
  4. A standing notice gives up its corner instead of covering the model picker, and its clock pauses while a person is reading it.
  5. The viewer hands the keyboard back to the pane it came from when it closes.

The sidebar and spaces

  1. A pinned chat is drawn as a conversation, with its name. A pin belongs to the project it was made in, and survives the project being renamed.
  2. Adding a space answers again, from each of the three doors that offer it.
  3. Sideways scrolling is repaired on eight surfaces, and an empty sidebar section shows only its heading and its plus.

0.2.4

Download for Mac290 MB · macOS 14 or later

0.2.4 is a correction release for the surfaces a person met in one evening of use: a Space switch that left the window half drawn, a chat created only after a second press, a tab row that could outgrow its header, an image that never reached the window from a chat, pins that crossed between projects, and a model list that offered every provider at once.

Every row it carries is a repair; the version adds no new surface.

Moving between projects, and the sidebar

  1. Switching a Space either draws the destination whole or refuses and leaves the workspace usable. It can no longer leave the window half drawn, with an error where the product should have been quiet.
  2. The tab row is one line at every width. Tabs give up width as the row fills and shrink to a single glyph, and only then does the row scroll. The header no longer grows with the number of tabs.
  3. Pinned pages, chats, collections and boards belong to the project they were pinned in and are no longer drawn in another project's lane. Nothing already pinned is lost.
  4. The plus where chats are created starts a conversation in one press. The menu that asked for a second press is gone.

The chat

  1. A picture pressed in a chat opens the product's viewer over the whole window. It used to open the chat's own frame-confined preview, which filled the column it was opened in and left the sidebar and the header standing beside it — in the side chat and in the full-screen chat alike.
  2. A conversation that is slow to open says so, and offers a retry. The wait is bounded at thirty seconds instead of standing on Loading history… for as long as the read takes, and returning to a project shows the conversation it was reading rather than loading it again.

The model control

  1. The model list under a chosen provider is that provider's models. The rows drawn, what a typed word searches and the count printed are one set, where the search used to offer every provider's catalogue at once.
  2. A model name too long for its row says the model's name and its provider, on hover and on keyboard focus.
  3. Choosing a model applies. The door no longer asks a model that declares no reasoning level for one, which is the disagreement that made The model change could not be confirmed unavoidable — and left every later message in that conversation refused.

0.2.2

0.2.2 is the version where the workspace becomes fast and steady. Its work is the system a person lives in all day — the tab strip, the left sidebar, the side peek and the side panel — rebuilt to open anything within a strict budget and to agree with each other in every case; one notification system in the top corner that replaces the errors drawn in odd places; menus that open where they should; one icon set drawn one way; and the chat that opens as itself, with its conversation, every time.

0.2.1

0.2.1 is a repair version. Its work is concentrated on the surfaces a person uses all day — the conversation list and the chat, the model and provider pickers, the tab strip, dictation, and the wait between opening the application and being able to work in it. It also carries a few new things: a subagent can be given a persona and a profile, a collection in the sidebar opens into its views, and a document the product cannot read can be handed to an agent to repair.

New in this version

  1. A subagent can be given a persona, a profile and its own contexts, and works in that voice with those contexts loaded.
  2. Choosing a provider is one road instead of guesswork: every provider the assistant already has is offered ready to choose, and adding another is a single named path to the Models page.
  3. A runtime installed on this computer is offered in the chat's provider list, with the models it holds.
  4. A collection in the sidebar opens into its saved views, each with its own icon, its name and how many items it holds, and the opened state is still there after a restart.
  5. A document the product cannot handle offers a control that hands it to an agent with the failure, and the repaired document is drawn afterwards.
  6. The Library names the kinds of thing it holds and reaches each in one press, instead of sorting them under Pages and Collections.
  7. The plus in the tab strip offers recent documents and recent chats side by side, and creates either.

The chat and its conversations

  1. The conversation list is there when the chat opens, is never emptied by a failed read, and one conversation it cannot name no longer blanks the rest.
  2. An opened chat wears its own name from the first frame, and sending a message no longer shifts or flickers the transcript and the composer.
  3. A failed turn keeps the words in the composer and brings the transport back by itself, so nothing has to be reloaded; a just-sent message stays where it was written.
  4. A conversation with running subagents carries a work indicator in its sidebar row.
  5. An agent a person made can be addressed by name in the chat, and it answers.
  6. The application opens its chat on the first load instead of answering that the chat is not installed.
  7. The New conversation press always produces a conversation, and it is opened where the person can see it.
  8. Changing the model or the reasoning level in a chat that has already answered is accepted, and a chat where nobody has chosen a level starts at the highest.
  9. Conversations are grouped by plain periods — Today, Yesterday and the wider buckets after them — and each heading's count equals the rows it shows.

0.2.0

0.2.0 is the first version of Shtukbase a person can actually use.

  • The assistant — built in, and working inside the workspace.
  • Collections and databases — the items, their properties, and the views over them: table, board, gallery, list, calendar, timeline, form.
  • Pages — the document surface, a page's children, and a page's properties.

It is the first more-or-less stable version. Three parts are present and are not yet steady, so nobody should lean on them yet:

  • audio recognition — present, not yet stable;
  • the graph — not yet stable;
  • the canvas, the board a person arranges by hand — not yet stable.

Installing

  1. Open the downloaded file. A window appears with two things in it: Shtukbase, and your Applications folder.
  2. Drag Shtukbase onto Applications. That is the install.
  3. Eject the opened image and put the downloaded file in the bin. It is not needed again.
  4. Open Shtukbase from Applications. The first open asks whether you meant to open an application downloaded from the internet. Press Open.