Skip to content

v0.1.6

Choose a tag to compare

@github-actions github-actions released this 02 Oct 09:07
· 226 commits to master since this release

Your agents reach your phone, agents hand work to each other, and git has a window of its own.

New

  • Your phone — conch web serves the agents on your laptop to a phone over your own tailnet. Pair it by scanning a QR code (conch web pair, or 🌐 in the status bar): the code works once, for five minutes, and travels in the link's fragment, which a browser sends to no server. The app is served by the gateway, so it always matches your build — add it to the Home Screen and it opens like an app. An inbox of what needs you; an agent's conversation with the question it is waiting on and its choices as buttons; its terminal to type into, with a key row for esc, tab, ctrl, alt and the arrows; + to start a task, an agent or a terminal. Scrolling back through an agent's own conversation works as it does at the laptop. Notifications when an agent waits or finishes. Permissions per device — view, reply, full — checked on every request and every message, with conch web devices|revoke|permission to change your mind. Nothing goes through a service of conch's.
  • Agents working together — conch agent prompt ID TEXT gives an agent its next message and is refused while that agent is waiting on a question of its own, so nothing is typed over a permission dialog; -wait blocks until the work it started ends. Panes have names (conch rename, conch task -name), and every pane command takes one. An agent calling conch from inside its pane reaches only its own work — the panes it started, its project, that project's branches — found from the socket's peer pid rather than anything the agent can set, and carried to other machines through -m. conch's own skill teaches the agents these commands: conch agent skill, or from Settings → Agents and the i view. In the TUI, Prompt… on an agent's pane menu, and a helper's row says ↳ for claude while its creator counts them (⑂2, amber when one is waiting).
  • A git window on a branch — click a branch (or b, $): a prompt that runs any git command in that branch's worktree, with the everyday ones behind tab, 500 lines of output kept, and a stopped rebase offering continue, abort, or handing the conflict to the agent. ctrl+t sends what you type to the agent on the branch instead.
  • Your own setup, and a library — conch agent sync -user gives the other agents the setup in your home, not just a checkout's, with an undo. conch agent library keeps MCP servers and skills in conch and writes them where each agent looks, Devin included. An agent cannot rewrite either of them.
  • The plan usage window — click Claude 5h 42% · 7d 18% in the status bar: every agent that has reported, on every machine, with every window it named — including a weekly allowance for one model that conch had been dropping — each with a bar, when it resets, and when the agent last said so. What conch itself has seen that machine spend is shown apart from it, and labelled as what it is.
  • The mouse — drag a tab along the bar to reorder it; drag a split's title onto another to swap the two; grab the scrollbar on a pane's right edge; triple-click for a whole line; click a link an agent printed to open it (alt+click inside an agent's own interface, which is owed its clicks). [ui] hover lights what the pointer is on, off by default because it asks the terminal to report every move.
  • File icons for 218 extensions and 95 names, from the Nerd Fonts list, and each Oh My Zsh theme showing the prompt it draws, in its own colours.
  • A new mark — a white conch on conch's teal, in the browser tab, on the website and on the phone, where it is the icon a Home Screen keeps.
  • A task in a folder that is no git repository starts the agent there; every sandbox command names its provider, since a default hides what is running on the other one.

Fixed

  • A command copied from a pane is one line again. A line too long for the pane is several rows on screen, and the copy put a newline between every one, so pasting into a shell ran half a command.
  • Claude's state is read from its spinner, not from "esc to interrupt" — which is on screen while it sits idle, so agent prompt -wait could call a thinking agent finished.
  • Tabs of panes that went while the TUI was closed close with them, instead of coming back empty and piling up.
  • An agent's conversation is kept as it scrolls above a fixed prompt, so ctrl+b [ reaches what it said rather than nothing.
  • A file copied out of the explorer is the file. The selection keeps to the column it started in, so the list beside the preview no longer comes with it, and it starts past the line numbers the preview draws them with — only the first row of a selection begins where the pointer did, so a command read out of a file used to paste as │ 2 go test and run nothing. w says which checkout it moved to, and the hint names y, d and e, which were there all along.
  • Sandbox creation that could not connect is tried again rather than deleted at the first dropped connection.

Known

  • The phone's notifications have been seen on one iPhone and nowhere else; a view device, Android, and anything on a slow link are unproven.
  • boat.dev is supported and documented, but the account it was built against has lapsed, so its stop/resume, usage and snapshots are covered by tests rather than a live run.
  • The gateway reaches a phone over Tailscale, behind any tunnel with -url, or with a certificate of your own. There is no relay: a relay would see everything, since pairing makes a bearer token and not a shared key.

Install

curl -fsSL https://raw.githubusercontent.com/Amitgb14/conch/master/install.sh | sh

An existing install updates itself with conch update, or from the version popup in the status bar.