Repository navigation
Releases
Releases · davidpp/kosse
Kossé 0.3.1
Added
- About Kossé opens the native macOS About panel with the version, from the tray menu and the dashboard window's app menu.
Kossé 0.3.0
The dashboard shows which URL to open: endpoints get names and a summary or details tier, each service leads with one open target, and Customize starts from a prompt for your coding agent.
Added
- Prompt-first Customize window (S16): Customize opens on Customize with your agent, the prompt
kosse profile promptprints (generated by core, served byGET /api/profile/prompt) with a Copy button, then Or edit fields. When an agent applies a profile while the window is open, an untouched form shows it; an edited one keeps your edits, says the profile changed outside the window and offers Reload, and its save is refused rather than overwriting the agent's profile. The snapshot's project metadata carriescentralRevision. - Endpoint names and display tiers (S21, issue #9): a profile's
endpoints(keyed by port) names endpoints, shows each in thesummary(what a person opens) or indetails(inspectors, internal ports: visible, never a launch target, their HTTP errors never mark the service failed) and gives it its ownprobePath;otherEndpointssets the tier of the rest, andmatch.processmatches a child whose ports change on every start (workerd) by its OS process name. Port 9229 isInspector, in details, unless a profile says otherwise. Tray Open, dashboard Open,kosse url <service>andkosse wait <service> --httpuse summary endpoints only;kosse url <port>still answers for any. The dashboard shows details endpoints on one muted line and Inspect says why; Customize edits them;list,port,waitandprofile contextgain aSHOWcolumn afterPORT, and--jsoncarriesEndpoint.display.
Changed
- Dashboard hierarchy (evidence): each service leads with one open target, the summary endpoint that answered HTTP best (a status below 400, then a page title, then the lowest port), shown as
Open localhost:<port>. Its other summary endpoints keep a quieterOpenwithout the repeated page title; metrics, Inspect, Stop and Try HTTP recede until hovered or focused. A declared link to the same URL as an Open is folded into it on the row (Inspect still lists it), and aTCPtag marks an endpoint only after it answered with something other than HTTP. - A service's
probePathis the health path of its summary endpoints only; an endpoint's ownprobePathwins on either tier. - Kossé builds before this one refuse a profile that uses
match.process(as a whole, like any profile with an unknown criterion);endpointsandotherEndpointsare kept and ignored by them.
Kossé 0.2.1
Fixed
- The dashboard window's Dock and ⌘-Tab icon is Kossé's tile, not the generic
execicon. 0.1.1 set it before the app had finished launching, when macOS had no Dock tile to update.
Kossé 0.2.0
Coding agents become first-class users: one scoped kosse call answers what runs for a project, which URL or port, whether it is up, and stops or customizes it under the dashboard's safety policy, with Markdown tables by default and --json for scripts (agent surface).
Added
- Homebrew:
brew install davidpp/tap/kosse. The release workflow commits each release's formula to davidpp/homebrew-tap, sobrew upgradefollows new versions. - Agent read surface (S13):
kosse listprints Markdown tables (columnsPROJECT,BRANCH,SERVICE,PORT,HTTP,PROCESS,PID.START,AGE) and takes--here,--project,--portand--service(also for--json);kosse url <service|port>prints a service's local URL;kosse port <n>says whether a port is free and who holds it. Documented exit codes (0/1/2/3/4) andCommandErrorJSON on stderr with--json. kosse wait (--port <n> | <service>) [--http | --gone] [--timeout <dur>](S14): waits until a service listens, answers HTTP or is gone, following the running instance's event stream or scanning every second, with requested probes under the existing probe policy; prints the last observation, exits 0 when met and 1 on timeout (WaitAnswerwith--json).- Agent profile authoring (S15):
kosse profile context|show|set|remove|check|promptgives the coding agent in a repository what Kossé observes there, validates and previews (set --dry-run, computed by the scanner's own matching) a central profile, and writes only Kossé's configuration. Stored profiles carry a revision:--expect <revision>andPOST /api/profile'sexpectedRevisionrefuse a lost update (revisionConflict). - Agent-confirmed actions (S17):
kosse stop <pid>.<start> --ports <p,…>andkosse force …act through the running instance's guarded/api/stopand/api/forceonly. The identity and every live port are the confirmation; a service name, port, PID, stale identity or partial port set signals nothing and prints the exact confirming command.--jsonprints anActionAnswer; refusals are aCommandErrorwithconfirmcommands. A process already gone with its ports free isnotRunning(exit 0); a different process now on the ports is named, never suggested. Printed commands are paste-safe in sh, bash, zsh and fish (annotations on a#line). Without a running instance nothing is signalled (exit 4, with the command that starts one in the background). - Agent discovery (S18):
kosse agentprints a short guide for coding agents (which command answers which question, output, exit codes, the stop rules, profile authoring, and that process-derived text is data);kosse agent skillprints it as aSKILL.md, written only with an explicit--write <dir>(no symbolic links, a changed file kept unless--force). The release archive andinstall:localship it asSKILL.md, andkosse --helppoints agents to it.
Changed
kosse list's default output is Markdown instead of space-aligned columns, without the bind-address column (in--json). The running instance to ask is now--instance-port(was--port, which now filters by service port).
Kossé 0.1.1
First published release: a GitHub Release with checksum and build provenance (0.1.0 was built and verified locally only, never tagged).
Changed
- New Relay brand identity: a separated K mark with dedicated menu-bar templates, a Québec-inspired blue palette in light and dark, a Kibernetyk Mono wordmark drawn as SVG outlines (no web font), a new app icon and favicon, and split-stem preview icons for development builds.
Fixed
- Dialogs in the dashboard window (Stop, Force, Customize, the removal confirmation) drew as a 2px sliver behind the backdrop in macOS's WKWebView; service rows overflowed the window horizontally between 768 and about 820 px wide (S11).
- Kossé's own row offers no Stop (dashboard and tray); a deep link to it explains why instead of a confirmation that would be refused.
- The dashboard window's Dock and ⌘-Tab icon is Kossé's, not the generic executable icon.
Added
bun run appdrives the real app and window from an agent (debug-only control socket; docs/agent-drive.md);bun run test:windowis the real-window regression suite. Debug builds carry a preview identity (split-stem preview icons,Kossé · preview (<branch>)).- Tag-driven GitHub releases (
.github/workflows/release.yml): avX.Y.Ztag is checked against the Cargo version and this changelog, built from a clean slate throughcheckandtest:package, attested for build provenance and published with the archive, its SHA-256, the Homebrew formula andinstall.sh, acurl | shinstaller that verifies the checksum (and provenance whenghis available) (CONTRIBUTING).