@shardflux/menubar-darwin 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.3.0
+
+- “Try it once” reaches its result and Continue when a Codex Cloud conversation finishes its turn; Claude keeps its existing finish detection too.
+
+- First run: a Codex Connect whose enable fails shows the error and Retry instead of a spinner that never ends, and a browser tab that is still "Untitled" is not counted as a screen the agent tested.
+
+- Sign-in shows "By continuing, you agree to our Terms of Service and acknowledge our Privacy Policy" under its two buttons, with both links; either button is the agreement (the app passes `--accept-terms`). Continue in browser names this Mac on the sign-in page ("Shardflux for Mac on <computer>").
+
+- Move the launcher by dragging its background or edges, like Spotlight. It reopens where you left it on each display and always stays fully on screen, including after a display change. Settings → Launcher → **Reset launcher position** returns it to the default; double-clicking the background resets the current display.
+- Capture part of the screen from the launcher: the camera button or **⇧⌘S** hides the bar and dims every display; drag across a region to attach it at native resolution. **Esc** cancels the capture and returns to the bar with your text and attachments; a second **Esc** closes the bar. Up to five captures appear as thumbnail chips with × to remove and a preview on hover or click. The first capture asks macOS for Screen Recording; without it, the launcher shows one line with **Open System Settings**.
+- Captures stay in memory: ScreenCaptureKit returns the image, the PNG goes to `shard agents new --image -` on standard input and from there into the conversation VM. No file, temporary file or clipboard is used on the Mac. Requires CLI 0.15.0.
+
+- First run: sign in to Shardflux from the window (Continue in browser, which confirms a code in the browser, or Continue with ChatGPT), connect Claude and/or Codex on cards checked live (Codex counts as connected with its remote device; a failed or stuck one offers Retry, which restarts it once), then try it once hands-on: copy the task, open the launcher, paste it, pick Daylight (sample) and watch the agent's own computer test it, then your own project. Settings → Agents uses the same cards, with T3 Code shown when it is installed. Completing each step answers with a short spring and a light trackpad tick (checks that draw on, keys that go down, a connected glow that blooms); with Reduce Motion every transition is a cross-fade. Resume any time from Settings → Show onboarding.
+
+- Settings links use the standard square-and-arrow external-link symbol.
+
+- Open update checks and recovery in Settings → Updates. Use purpose-specific project and file pickers that start in the current project. Keep launcher projects injectable for the shared catalog.
+
+- Use concise, grouped native notifications with Open conversation, Sign in, or Review/Deny actions. Approval notices open the same scoped panels; conversation notices use the CLI open target.
+
+- Replace credential NSAlert with a scoped native approval panel. Keep future auto-approval and saved sign-in consent separate; report a failed remembered-login save after successful fulfillment without retrying the approval.
+
+- Move preferences into a standard macOS Settings window (Cmd-Comma): Account, General, Agents, Launcher, Notifications, Updates and About. Keep only Settings, Check for updates and Quit in the overflow, and move the one-time shortcut hint out of the launcher. Read account, plan, usage and spend metadata; show installed CLI/menu/SDK versions and preserve shortcut/profile/notification preferences. Keep missing agent connection metadata explicit. Add native template/app icon families and a quieter two-row launcher.
+
+- Simplify the menu to one-line live conversations, collapsed done sessions, conditional approval cards and one overflow menu.
+- Open the same floating launcher from New conversation (⌘N) or a configurable global Option-Shift-Space shortcut, with conflict checks.
+- Require a task and project; remember the app and project, detect readable frontmost project context, fuzzy-search projects/live conversations, and add text-file, branch or clipboard-link context. Cmd-Enter starts and Esc closes.
+- Open conversations through the CLI-selected app without a terminal. A failed open can be retried without starting another conversation.
+
 ## 0.2.0
 
 - Own the conversation device worker and show Allow once, Always for this project and Deny notification actions. Outside-worktree access asks separately.

package/README.md

@@ -1,6 +1,6 @@
 # Shardflux menu bar for macOS
 
-The native app payload for `shard menubar` (CLI 0.14.0+), version **0.2.0**. macOS 14+, Apple Silicon and Intel.
+The native app payload for `shard menubar` (CLI 0.15.0+), version **0.3.0**. macOS 14+, Apple Silicon and Intel.
 Install once with `npm i -g shardflux`, then run `shard` or `shard ./` on a project. The CLI installs the app in
 `~/Applications/Shardflux.app` and starts it automatically on macOS the first time `shard` runs, with launch at login enabled.
 
@@ -9,8 +9,8 @@ shard menubar status --json
 shard menubar stop
 ```
 
-The menu shows project sessions, opens them in your remembered app and notifies when an agent needs you.
-It reads the CLI's saved profile and project key; enable notifications in the menu. `shard menubar stop` turns
+The menu shows live conversations in one-line rows. Click a row to open it; hover or right-click to archive it. Finished conversations collapse under **N done**. The **⋯** menu contains **Settings…**, **Check for updates** and **Quit**. A dot marks an available update.
+It reads the CLI's saved profile and project key; enable notifications in Settings. `shard menubar stop` turns
 it off, including launch at login.
 The npm package is a universal ad-hoc signed app.
 Read [Cloud agents](https://docs.shardflux.dev/guides/cloud-agents#keep-agents-in-the-menu-bar).
@@ -18,16 +18,37 @@ Read [Cloud agents](https://docs.shardflux.dev/guides/cloud-agents#keep-agents-i
 
 ## Credential approvals (0.1.0+)
 
-The menu bar app shows pending browser login requests. Choose Allow once, Always for this project or Deny,
-and select a vault item. Remember for unattended use stores the selected login for fills while your laptop is away;
-the workspace relay renews automatically while its issuing principal stays authorized.
+The menu bar app shows pending browser login requests. In 0.3.0, choose Review to select your vault and login item, then Allow login or Deny. Choose **Ask every time**, **Allow for this project**, or **Allow on my machine (all projects)**. Machine permission applies to this account and profile; a saved project choice takes precedence.
+**Remember for unattended sign-in** is off by default. It saves only the requested fields, encrypted, for the current conversation, project template or machine template according to the selected scope. The scoped API must be available for conversation and machine storage. The workspace relay renews automatically while its issuing principal stays authorized.
 
 Vault fills: sent end to end from your vault to the workspace; Shardflux only relays encrypted bytes.
 Remembered credentials: stored encrypted with AWS KMS and filled straight into the page; agents never see it, and every use is logged.
 
 ## Conversation device tools (0.2.0+)
 
+In 0.3.0, Review opens a native approval panel with the exact command, file paths or port mapping. Outside-conversation access only offers Allow once. Notifications open the same panel; they do not bypass review.
+
 The background helper runs approved device commands, transfers files, opens localhost ports and mirrors your cloud
-conversation transcripts. Choose **Allow once**, **Always for this project** or **Deny** in the notification.
+conversation transcripts. Open **Review** from the notification, then choose **Allow once**, **Always for this project** or **Deny** in the panel.
 Paths outside a conversation’s local worktree ask separately. When an ACP application is connected, its own
 permission prompt handles the request. Project grants live in `~/.config/shardflux/device-grants.json`.
+
+## New conversation (0.3.0+, CLI 0.15.0+)
+
+Press **Option-Shift-Space** from any app, or choose **New conversation** in the menu (⌘N). In the floating launcher, describe what the agent should do, choose a project and Claude or Codex, then press **⌘Enter**. Both the task and project are required. Your task becomes the conversation's first user-authored message.
+
+The launcher remembers the agent and last project. It uses the frontmost app's working folder when macOS exposes an unambiguous folder without extra permission. Otherwise it keeps the last project. **Tab** searches recent local projects or opens **Choose folder…**. Typing also searches live conversations; use the arrow keys and Enter to open a match. Add up to five small text files, branch context or a clipboard link through **+**, or drop text files into the panel. These become text context in the first message. **Esc** closes the panel and returns focus.
+
+Show the agent what you see: click the camera button or press **⇧⌘S**, then drag across any part of any display. The capture is attached at native resolution as a thumbnail chip; hover or click it to preview, × removes it, and up to five fit. **Esc** during a capture returns to the launcher with your text and attachments; a second **Esc** closes it. The first capture asks macOS for Screen Recording; if it is off, the launcher shows **Open System Settings**. Captures stay in memory on your Mac and go straight into the conversation's VM, where Claude and Codex open them.
+
+Drag the launcher by its background to put it anywhere. It reopens there on each display and always stays fully on screen. **Settings → Launcher → Reset launcher position**, or a double-click on its background, brings it back to the default spot.
+
+Open the standard macOS **Settings** window from **⋯ → Settings…** or **⌘,**. **Account** shows your account, plan and current-period usage. **General** contains the profile, launch at login, command center and archive recovery. **Agents** shows available sign-in and connection metadata. **Launcher** contains the shortcut recorder, conflict notice, project-detection preference and **Reset launcher position**. **Notifications** controls waiting and approval alerts with the macOS permission state. **Updates** shows installed versions and one update action; **About** has documentation and support links. Missing server metadata is shown as unavailable, never inferred from saved credentials.
+
+The app checks readable shortcut preferences and uses macOS hotkey registration, without Accessibility permission. It avoids the standard Spotlight, input-source, desktop assistant and 1Password combinations; if Option-Shift-Space is taken, it tries Control-Shift-Space, then Control-Option-Shift-Space.
+
+Settings uses the Shardflux mark beside your account. Claude and Codex icons come from the installed apps through macOS, matching your Dock. If no app is installed, the app uses an unmodified official publisher mark. The same icons appear in conversation rows, the launcher and conversation notification attachments.
+
+This uses `shard agents new --app claude|codex --path <folder> --prompt-file <file> [--image -] --json` (captures as PNG on standard input, CLI 0.15.0+), then the same `shard agents open <workspace> --in auto --json` path as session rows. The CLI chooses the destination. Progress and errors stay in the launcher; **Open created conversation** retries an existing creation. The menu is optional: both CLI commands work independently.
+
+On macOS 26, the menu, launcher and approval panels use native Liquid Glass; Settings uses native translucent materials and unified toolbar chrome. macOS 14/15 keeps live frosted materials. Reduce Transparency and Increase Contrast select solid backgrounds. See the repository’s `apps/menubar/GLASS.md` for the shared onboarding integration API and build requirements.

package/Shardflux.app/Contents/Info.plist

@@ -6,9 +6,9 @@
 <key>CFBundleDisplayName</key><string>Shardflux</string>
 <key>CFBundleExecutable</key><string>ShardfluxMenuBar</string>
 <key>CFBundlePackageType</key><string>APPL</string>
-<key>CFBundleShortVersionString</key><string>0.2.0</string>
-<key>CFBundleVersion</key><string>0.2.0</string>
-<key>CFBundleIconFile</key><string>AppIcon.png</string>
+<key>CFBundleShortVersionString</key><string>0.3.0</string>
+<key>CFBundleVersion</key><string>0.3.0</string>
+<key>CFBundleIconFile</key><string>AppIcon.icns</string>
 <key>LSMinimumSystemVersion</key><string>14.0</string>
 <key>LSUIElement</key><true/>
 <key>NSHighResolutionCapable</key><true/>

package/Shardflux.app/Contents/Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/FunnelDisplay-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2023 The Funnel Project Authors (https://github.com/Dicotype/Funnel)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/Shardflux.app/Contents/_CodeSignature/CodeResources

@@ -4,9 +4,9 @@
 <dict>
 	<key>files</key>
 	<dict>
-		<key>Resources/AppIcon.png</key>
+		<key>Resources/AppIcon.icns</key>
 		<data>
-		bwEoFxbActJSRxfsqPzF6Il7w8s=
+		0t6cc8O2ixscotnJcHyFzEMWbIY=
 		</data>
 		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/FragmentMono-OFL.txt</key>
 		<data>
@@ -16,6 +16,14 @@
 		<data>
 		Z1aQOuwnCBNExluOAU7PV+hjI2w=
 		</data>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/FunnelDisplay-OFL.txt</key>
+		<data>
+		6o/yGJb4VcpycfnHO4/kwLZA9zI=
+		</data>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/FunnelDisplay.woff2</key>
+		<data>
+		KkHGPqZvV4wjoZfHAWQehb60INY=
+		</data>
 		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/FunnelSans-OFL.txt</key>
 		<data>
 		39ByxeaPqYemGOb34Ry4SSHxD3Q=
@@ -24,10 +32,26 @@
 		<data>
 		+kG1vG/EssTUM+JBXpJz7M2kfM4=
 		</data>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/claude-mark.png</key>
+		<data>
+		NpsU6ArGQ8wJ3M1YHMuR+CtVkZA=
+		</data>
 		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/mark.json</key>
 		<data>
 		tbPtIGfglDVd7/EDqk9qTwKjy4M=
 		</data>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/onboarding-silk.jpg</key>
+		<data>
+		LxaY9uDWywzO6Q1B+PsD9cLNlvg=
+		</data>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/onboarding-wash-warm.webp</key>
+		<data>
+		dTLuGoywG/uYW0Nli1YdXcBhH4k=
+		</data>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/openai-mark.png</key>
+		<data>
+		uvNLv+0ivlI3IwmzlX5bwJ4QAEU=
+		</data>
 		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/shardflux-mark.svg</key>
 		<data>
 		tdnXwAq5B9gcfRKUVg/IWnFdL/w=
@@ -39,11 +63,11 @@
 	</dict>
 	<key>files2</key>
 	<dict>
-		<key>Resources/AppIcon.png</key>
+		<key>Resources/AppIcon.icns</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			aYEpoqQgxqyVXL4CS51DxJAVjDbh1/jL7h7ZuljFwnE=
+			7TnSjrqMargsym/NPKErg6bOwELJ7qBDadASbkFTMVQ=
 			</data>
 		</dict>
 		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/FragmentMono-OFL.txt</key>
@@ -60,6 +84,20 @@
 			D+AR9CWHPC4PxzoYnjlONArUjSuamaV2ve7HXO4ABGA=
 			</data>
 		</dict>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/FunnelDisplay-OFL.txt</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			ClZXYCg0ADo8TkHN8jwoYqs0PPAFxjNTgadThSkODB4=
+			</data>
+		</dict>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/FunnelDisplay.woff2</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			x9bBQ477aBJp5pT+CK2Ev395preTnUlVRiF/zvE0aAI=
+			</data>
+		</dict>
 		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/FunnelSans-OFL.txt</key>
 		<dict>
 			<key>hash2</key>
@@ -74,6 +112,13 @@
 			ZSyYNENLwBg1xOdac9PH5C/y5L6yYcyFHLkR6Imvanc=
 			</data>
 		</dict>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/claude-mark.png</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			zn6Mr+J2xNaCA4dlLXdDd3L7Lvp1Eb/5Kk52ZM0r7lE=
+			</data>
+		</dict>
 		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/mark.json</key>
 		<dict>
 			<key>hash2</key>
@@ -81,6 +126,27 @@
 			2nrbIjNftzBqYmVZxxekdkxMM5X0lh5MiRmWD8JdZDI=
 			</data>
 		</dict>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/onboarding-silk.jpg</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			9t4r+cTLunpE/wRikwB7/l+WZz9SfD4lhtIUWi5afKU=
+			</data>
+		</dict>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/onboarding-wash-warm.webp</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			8P3vxbd7O/9b+r111vNUyvVx7DwGuce8G0E7eGXvv0w=
+			</data>
+		</dict>
+		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/openai-mark.png</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			55ni+g1BSaLsKPxZXIv7SZC8u0eGSXkbQqz/fN5ugF4=
+			</data>
+		</dict>
 		<key>Resources/ShardfluxMenuBar_ShardfluxMenuBar.bundle/Resources/shardflux-mark.svg</key>
 		<dict>
 			<key>hash2</key>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/menubar-darwin",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Shardflux macOS menu bar app",
   "type": "module",
   "license": "Apache-2.0",