> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinework.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Changelog
> What's new in Pinework: the Mac app, the CLI, the dashboard and iOS.
The dashboard updates on its own. Each entry below is a Mac app and CLI release.
> **A new look in the Mac app, the dashboard and iOS. Your device shows online only once it is.**
> Download this version once by hand. Later versions install on their own.
### New
* **A new look.** Every page, dialog and menu is redrawn, in light and dark.
* **Threads in chat.** Reply in a thread without breaking the main conversation.
* **Type @ to mention an agent, task or file.** Links show as pills you can open.
* **Voice input.** Speak a message in the Mac app or on iOS instead of typing it.
* **Workspace goals.** Set them in Settings, and every agent reads them when it starts work.
* **Agents remember.** Each agent keeps memories and a day log in its Memory tab.
* **A new menu bar icon** shows live status, with a native menu and your account.
### Changed
* **Runs and task activity open in a side panel**, next to the chat.
* **Setup brings your Mac online before it imports**, and connects Claude at the last step.
### Fixed
* **The Mac app updates itself again.** Older versions could download an update but not install it.
* **Your device shows online only after it connects**, and it starts again when you reopen the app.
* **Continue setup picks up where you left off** instead of starting over.
* **An open question stays under Needs you** in the inbox until you answer it.
* **Tools you pick during setup now connect** instead of leading nowhere.
* **Messages you send to a cloud run mid-run always arrive.** About half used to get lost.
> **Setup ends in a chat with Chief, your first agent.**
> Also fixed: paying in the Mac app, starting your device, and importing from your Mac.
### New
* **A new setup flow.** One screen at a time: your workspace, your tools, your first agent, then a chat.
* **Chief is your first agent.** Setup opens a chat with Chief, ready to help set up your workspace.
* **Pick a folder with the Mac folder picker** instead of typing its path.
* **Choose each item to import.** Tick skills, plugins, MCP servers and hooks one by one.
* **Your Mac shows up by its own name**, so two Macs are easy to tell apart.
### Changed
* **The inbox shows only what needs you.** Conversations show their unread count.
* **One MCP list.** The Integrations page is gone, and its servers live in the MCP list.
* **Agent settings show every rule.** Instructions open in one editor, with token counts per item and in total.
* **Tasks and chats open faster.** They paint from the row you clicked.
### Fixed
* **Paying in the Mac app no longer signs you out.** Checkout opens in your browser, and the app moves on once you pay.
* **Your device starts** when the Mac app opens and from the tray's Start.
* **Import says when your device is stopped** and offers to start it.
* **A folder macOS blocks shows an error** with Try again, instead of looking empty.
* **Chat replies no longer show internal log lines.**
* **Setup no longer loops back** on every launch after an error.
> **The CLI now updates itself**, and the Mac app installs updates once you step away.
> Also new: @mentions for people, a searchable model picker and repo folders on your device.
### New
* **The CLI updates itself.** It checks for a new version before each command.
* **Updates install when you step away.** The Mac app restarts into a waiting update once no window has focus.
* **Mention a person.** An @mention of a teammate lands in their inbox, and they can reply from there.
* **Pick the repo each device folder holds.** A run for that repo starts in its folder.
* **Search the model picker** by name, price or context size.
* **Answer from the CLI.** Answer questions, decide approvals and accept or reject learnings without the dashboard.
* **Edit your profile.** Settings shows your handle, role and description.
### Changed
* **Accepting a learning creates a task** for the agent that wrote it.
* **Fewer toasts.** Only real notifications pop up, and a failed run shows once.
### Fixed
* **Quitting the Mac app no longer stops your device**, so runs keep going.
* **Your tokens no longer reach agent commands** run on your device.
* **Missed routines fire.** A schedule that slipped runs as soon as it can.
* **In-app links open in place** instead of reloading the whole page.
> **The Mac app is now built for Apple Silicon only**, and the CLI installs again on macOS.
> Also new: a terminal in the side panel, file history and plugin marketplaces.
### New
* **A terminal in the side panel.** The Mac app opens a terminal tab next to your work.
* **File history.** Every version of a file is kept, and the viewer lists them.
* **Plugin marketplaces.** Install a plugin by name, or paste a GitHub link to install skills.
* **Search covers conversations and agents**, and it finds results by meaning.
* **Routines start on GitHub events.** Trigger one when a pull request merges, or when its checks pass (CLI).
* **Task watchers.** See who watches a task, and add or remove watchers from the task page.
* **The browser keeps you signed in** across every tab an agent opens.
### Changed
* **Apple Silicon only.** The Mac app and CLI no longer run on Intel Macs.
* **A new toast.** Swipe it away, and repeat messages merge into one.
* **The iOS app has a new design** for the inbox, chat, runs, agents and settings.
### Fixed
* **The CLI installer works on macOS again.** macOS no longer blocks the downloaded binary.
* **Image uploads in chat work**, and a failed send keeps your text.
* **Menus and toasts no longer blank the browser page** in the Mac app.
* **A run that crashes on your Mac resumes** once the Mac reconnects.
* **Cancelling a run stops it on your Mac**, not just in the dashboard.
> **A new look on every screen**, and one command installs the CLI. Also new: paid plans,
> channels with threads, and a wiki that learns from your agents.
### New
* **Install the CLI in one command.** One line on macOS and Linux. No npm, no admin password.
* **Plans and billing.** Settings → Billing shows your plan, your trial and your invoices.
* **Channels and threads.** Reply to a message and the replies leave the main stream.
* **The wiki learns from your agents.** Approve a short list of findings and the pages update.
* **One search covers pages, files and tasks**, so an agent finds an answer you already have.
* **Workflows are yours to edit.** A step runs your own command and branches on the result.
* **Per-task overrides.** Pin the model, the effort or the machine for a single task.
* **Settings history.** See who changed an agent or workspace setting, and when.
* **Connect a subscription instead of an API key.** Claude, ChatGPT and Cursor.
### Changed
* **Labels are gone, and agent settings are one page** instead of a maze of screens.
* **A new look on every screen.** One design across the dashboard and the Mac app.
* **The dashboard is much faster**, and a cloud run starts sooner.
### Fixed
* **Connecting a Mac is steadier**, and a failed attempt says what went wrong.
* **A busy provider slows a run down instead of killing it.**
* **A task keeps the model you chose after its first run.**
> **The app updates itself from here on.** Install this one by hand once. The next release
> downloads quietly and installs when you quit.
### New
* **Watch and steer a run from a card**, in the task timeline and on your phone.
* **A workflow step can run your test suite** on your own Mac and branch on the result.
* **`pinework watch`** tails everything happening in the workspace.
* **Give a repository a setup script**, so a cloud run starts from a prepared checkout.
* **Delete a conversation** from the dashboard, the CLI or the API.
* **The task timeline shows what shipped** — branches, commits and pull requests.
### Changed
* **Chat is grouped the way the rooms work**, on the web and on iOS.
* **A busy provider slows you down instead of stopping you.**
* **Agent heartbeats and agent pause are gone.** Use an automation to check in on a schedule.
* **Some CLI flags that did nothing are now rejected** instead of quietly ignored.
### Fixed
* **Typing `pinework` in a terminal runs the CLI**, not the desktop app.
* **A run that ended in a provider error reports failure**, with a named reason.
* **Turns are unlimited by default.** The ceiling exists only when you set one.
* **`run create` no longer throws away `--model`, `--effort` and `--env`.**
* **Answering an agent's question on iOS works.**
> **Talk to agents like a team, and bring a second provider.** Direct messages, channels and
> threads, plus ChatGPT and Codex subscriptions alongside Claude.
### New
* **Direct messages and channels.** In a channel, `@`-mention the agent you want.
* **Replies thread**, and an agent answering in a thread reads only that thread.
* **Connect a ChatGPT or Codex subscription** and run Codex agents on your own plan.
* **Connect Cursor and OpenCode keys** directly.
* **Steer a run mid-turn.** Type while an agent is working and it takes the input.
* **A task knows its pull request**, so you can see what the work changed.
* **Pick a task's repository and base branch.**
### Changed
* **A rate limit no longer kills the work.** The run finishes on your next credential.
* **Cloud runs survive a deploy** instead of being written off.
* **iOS caught up:** pull to refresh, editable tasks and wiki, faster chats.
### Fixed
* **A rate-limited run names its replacement** instead of reading as a crash.
* **`comment list` reaches page 2.**
* **A long command no longer makes a run look dead.**
* **A Claude subscription runs only on Claude Code**, and an OpenAI one only on Codex.
> **The Mac app is a third of its old size** — 335 MB, down from about 1.0 GB. Install this
> one by hand: it cannot update itself.
### New
* **The background helper has a name and an icon** instead of showing up as `node`.
### Changed
* **A much smaller app.** Dropping the bundled browser took about 724 MB out.
* **Opening a chat is one trip, not two**, and a revisit paints from cache.
* **Far fewer approval prompts for routine work.**
* **Workflows show their settings on the page**, and you answer a parked question there.
### Fixed
* **The browser tab shows the page** instead of a blank pane.
* **Workspace links move you inside the window** instead of reloading the app.
* **The folder browser, transcript paging and folder picker work again.**
* **The CLI names the person a run is waiting on.**
* **Thinking time does not spend your budget.** The clock pauses while you decide.
* **Only workspace admins can change workspace permissions.**
* **A path you deny is denied to search and the shell too**, not just to file reads.
> **Runs stop dying in the middle of work.** The window itself is unchanged. Install this on
> every Mac you run agents from, because that is where the fixes land.
### New
* **Agents open pull requests.** Each commit is authored as the agent that made it.
* **A run records where it ran**, so a result traces back to a machine.
### Changed
* **Answers arrive as they are written**, a word at a time.
* **A run waiting on you says so**, everywhere runs are listed.
* **Cloud runs start with less busywork**, and get more processor.
* **Your run history lives in Pinework**, readable even when the machine is off.
### Fixed
* **Runs no longer die mid-work** because a renewal ran late.
* **The background helper can no longer pin your Mac at 94% processor.**
* **A run that arrives while your Mac is full waits its turn** instead of dying.
* **A deploy no longer freezes an approval** already on screen.
* **A finished turn always shows the agent's answer.**
* **A cancelled run stops reporting \$0.00.** Unmeasured now reads as unmeasured.
* **A repository whose default branch is `master` can be cloned.**
* **230 archived transcripts became readable again.**
> **Pinework has a browser.** Open a real web page beside the conversation, point at anything
> on it, and the agent hears what you pointed at.
### New
* **A browser in the right panel** — live pages, clicking, typing, history and tabs.
* **Point at a thing on the page** and a description of it drops into the message box.
* **Connect GitHub**, and cloud agents use `git` and `gh` on your repositories.
* **Choose which notifications you get**, per kind and per channel.
* **Set how much an agent has to ask** before it acts.
* **`pinework models list`** shows every model you can pick.
### Changed
* **Approval cards show the command or file**, not just the name of the tool.
* **This download is about 480 MB, up from 114 MB.** The browser ships inside the app.
### Fixed
* **Approving from your iPhone works** instead of spinning forever.
* **"Always allow" now means always.** It used to forget after one session.
* **A run that worked is recorded as working.**
* **Cloud runs start again.** Every one was failing with a server error.
* **The Files panel stops emptying itself** the moment a turn finishes.
* **Deleting a wiki page frees its name.**
* **Only a person can answer an approval.** The CLI commands that bypassed you are gone.
> **Pinework now tells you when it needs you** — real Mac and iPhone notifications, approval
> cards where the work stopped, and a badge that counts what is actually waiting.
### New
* **Your Mac notifies you** when a run finishes or fails while you are elsewhere.
* **Your iPhone gets the notification too.**
* **An agent can ask you a question and get an answer back.**
* **A cloud run works on your repository.** Pick it, and the run starts from a clone.
* **`pinework` works in your terminal.** Installing the app puts it on your `PATH`.
* **A new workspace starts with three agents** — a planner, a builder and a reviewer.
### Changed
* **The side panel is usable.** Close a tab, copy a path, and keep your place.
* **The agent page names the model a run will actually use.**
### Fixed
* **Moving between screens no longer reloads the app.**
* **"Mark all read" visibly marks everything read.**
* **A chat finishes its turn** without you navigating away and back.
* **A failed run says why it failed.**
* **A message you type mid-run stays in the conversation.**
* **A second workspace no longer breaks the dashboard.**
> **A remote chat shows both sides.** Drive one Mac from another and your own messages appear
> as you send them.
### New
* **You can see what you said** when you drive one of your Macs from another device.
* **Long conversations are reachable.** Older messages load as you scroll back.
### Changed
* **Remote control is much lighter on the servers behind it**, so it holds up under load.
### Fixed
* **Your Macs are yours alone.** Only the person who enrolled a machine can see or control it.
* **Your iPhone stays signed in.** A rule written for always-on machines was signing it out.
> **Pinework goes multi-device.** Turn on remote access for a Mac and control it from another
> Mac or from your iPhone.
### New
* **Remote control your Macs.** Read live transcripts and start, stop and steer runs anywhere.
* **Pinework on your iPhone.** A full controller for any Mac you have enabled.
* **Chats stream as they happen**, with approvals answered inline.
* **Your local coding sessions appear in the Chats list**, grouped by machine and folder.
* **A library for plugins, skills, hooks and rules**, switchable per workspace or per agent.
* **Attach files to a chat**, and search every file in the workspace.
* **Use your own Claude subscription for cloud runs.**
* **An agent can wait for you** for up to 24 hours. Approvals collect in one Inbox.
### Changed
* **Cloud runs are open to everyone**, and a run resumes where its last turn stopped.
* **See what a run cost**, cache reads and writes included.
### Fixed
* **A dropped connection no longer takes your running agents down with it.**
* **Runs go to the machine you chose**, not whichever one happens to be online.
* **The model you picked is the model that runs.**
* **Approvals and questions on the task page load again.** They had failed for two months.
* **Correction: a run on your Mac stores its transcript in Pinework's cloud.** v2026.7.7 said otherwise.
> **`pinework login` lands in your Mac keychain for real**, so the desktop app picks up the
> sign-in you already did on the command line.
### New
* **Pick a folder on your Mac for agent work**, instead of a vague "local" choice.
### Changed
* **Settings → Import uses the same walkthrough** as first-run onboarding.
### Fixed
* **`pinework login` writes your login keychain reliably**, and repairs a broken search list.
* **A token with a `$` in it is stored exactly as you typed it.**
> **Sign in once on the CLI and the desktop app picks it up**, instead of asking you again.
### New
* **First-run is the real entry after you create a workspace.**
* **Choose which import groups to apply** before the wizard applies them.
* **iOS opens your workspace without a loading gate.**
### Fixed
* **The desktop app imports your CLI sign-in** rather than asking for a second one.
> **The desktop app and the CLI stop fighting over your sign-in**, and the shared keychain
> entry stops asking for your password on every read.
### New
* **First-run can import the setup already on your Mac.**
* **Edited messages keep their history.**
* **Link to any task, run, agent, project, file or wiki page** from anywhere in Pinework.
* **Wiki pages appear in ⌘K**, tagged with their tier.
* **Agents write wiki pages directly** with `pinework wiki create`, `update`, `delete`, `list`.
* **Wiki on iOS.** Browse a page, read its history, and search from the app.
### Changed
* **Re-importing documents skips every page that has not changed.**
### Fixed
* **No more repeated keychain password prompts.**
* **Checking which coding tools are ready stops hanging and leaving processes behind.**
* **Approving a waiting run keeps its prompt, its tools and its folder.**
* **Notifications show up while the app is open.**
* **Codex runs now start** instead of sitting queued forever.
* **Runs no longer die when you have more than one Mac connected.**
* **The CLI rejects a flag it does not know** instead of ignoring it.
* **A terminal you open from Pinework no longer inherits its environment variables.**
> **The desktop app opens again.** v2026.7.13 shipped without the settings it needed, so it
> spun on a loading screen forever.
### New
* **Agents read the company wiki** when they work on a chat or a task.
### Changed
* **The web app no longer carries the code that can reach your machine.**
### Fixed
* **The desktop app no longer hangs on a loading spinner.** A build missing its settings now fails.
> **The desktop app runs entirely on your own machine.** Its whole interface ships inside the
> app, so it starts faster and depends on nobody else to draw a screen.
### New
* **The interface ships inside the app**, instead of loading from the web on every launch.
* **A company wiki.** Write pages, read every revision, search by keyword and by meaning.
* **Automations.** Put a prompt on a schedule and run it against a chat or a task.
* **Imported sessions have their own place in the sidebar.**
* **Your Cursor settings sync per Mac**, alongside the tools already covered.
### Changed
* **The app paints immediately** instead of waiting on a first request.
* **A reworked file panel** with breadcrumbs, a tree you can hide, and a resizable viewer.
* **Imported Claude Code and Codex sessions get real names** from the folder they ran in.
### Fixed
* **Macs no longer get stuck on "Connecting".**
* **No more false rate-limit warnings**, and a finished answer stops disappearing.
* **Honest costs and token counts**, cache reads and writes included.
* **Reasoning renders in its own foldable block.**
* **Live updates keep flowing** instead of dying until the servers restart.
* **Comments show who actually wrote them**, not "Someone".
* **No more repeated macOS password prompts.**
> **Your Mac's sessions and settings sync on their own**, and Codex becomes a coding tool you
> can run under the same controls as the rest.
### New
* **Sessions and settings sync automatically, per Mac.**
* **Session history from Cursor and OpenCode**, read-only, labels and timings only.
* **Codex is supported**, with the same access, plan and approval controls as the others.
### Fixed
* **Cancelling a run works, and actually stops the agent.**
> **Run models on the subscriptions already on your Mac** — Claude, Cursor and OpenCode, with
> no API key needed.
### New
* **Run a model through a subscription you are already signed into.**
* **Pick a model for Cursor** — Claude, GPT, Gemini or Composer.
* **Subscription usage you can read**, labelled plainly as not billed.
### Changed
* **Tasks use your subscriptions too**, not only the chats you start yourself.
* **Much faster startup.** A run starts in seconds instead of minutes.
### Fixed
* **Pinework reconnects to your Mac on its own**, and re-checks which tools are installed.
* **Long replies keep streaming** instead of dropping after about a minute.
> **Opening the app from the Dock finds your coding tools.**
### Fixed
* **The app reads your login shell's `PATH`**, so it finds the tools you installed.
> **See your models, pick how each one runs, and set how much an agent may do alone.**
### New
* **A rebuilt model picker**, one row per model, grouped by provider.
* **Autonomy modes.** Plan, ask before changes, full access, or the agent's own setting.
* **A speed control**, shown only where the provider genuinely supports it.
### Changed
* **A chat stays on the tool it started on**, across turns and resumes.
* **A run with nowhere to go fails loudly, with a reason**, instead of vanishing.
> **Installing the desktop app is all you need** to run agents on your Mac.
### New
* **The piece that runs your agents ships inside the app.** No separate download.
### Fixed
* **The desktop app stays connected to the server.**
* **Adding a folder works on every Mac.**
* **Archived tasks open from their links.**
> **A public changelog, a native menu bar, and a file browser for every run.**
### New
* **A public `/changelog` page** — the one you are reading — with no sign-in needed.
* **A native menu bar** with reload, zoom, and a cache clear that does not sign you out.
* **Browse a run's working folder** in a tree, and read any file in the app.
* **Readable JSON** in the transcript and file viewers.
* **Choose whether session labels sync** to the cloud, per Mac. Off until you turn it on.
* **A usage page**, plus a reworked profile and settings area.
### Changed
* **Long chat transcripts are faster to scan.**
### Fixed
* **Closing the window no longer loses it.** The dock or tray icon brings it back.
* **Task links open the right task.**
* **A link to a deleted task shows a clear message**, and a way back.
* **Your Claude and OpenCode subscription sign-ins stay on your Mac.**
* **A run no longer picks up the host machine's own Claude settings.**
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.