Proto-Mind

Proto-Mind is a personal cognitive-agent architecture and native macOS workspace.

Portable beta for other users: the Apple Silicon macOS package includes its own runtimes, first-connection screen and per-user profile. It needs no source checkout, Homebrew or Node to launch. Published downloads and this development checkout can have different versions; a local build does not publish an update. Install and connect · Build and distribution status. The beta is ad-hoc signed and not Apple-notarized. The developer installation and its personal data remain separate from portable builds.

For current development guidance, see AGENTS.md. The current priority map identifies completed work and the next product stage. Architectural context and historical evidence live in PROTO_MIND_ARCHITECT_LEDGER.md.

Native macOS Direction

The current native workspace is Native 0.75.7 / PM Remote Preview, built with SwiftUI/AppKit over the existing Python cognitive core. Models can work with PM projects, conversations, browser pages, documents and explicitly connected services. This development line is separate from the earlier submitted Build Week baseline and published download.

PM Remote for iPhone (development): a native iOS client and optional Mac connection for selected projects/chats, reading replies, sending tasks and live updates, exact-turn Stop and new chats. It uses private HTTPS with local pairing approval, preserves Mac drafts and never automatically retries an uncertain command. Build, setup and verification boundaries. iOS installation is a separate step from building the Mac app.

Claude Code: sign in through Settings → Connections → Claude, then select Claude in any chat. The official SDK/CLI supports the user's own Claude Code subscription or explicit API login. Claude shares PM's editor, memory and journal; tools require the conversation's Mac access. Each conversation resumes its exact saved Claude session, including tool history. New sessions bootstrap from up to 300,000 characters of local conversation with explicit omissions; the former 12 × 2,000 limit no longer applies to Claude. While Claude works, a message typed in the chat reaches it as an update, as with Codex. Setup and current limits.

Claude continuity (0.74.2): a resumed Claude session receives current memory and Observer labels on every turn, and an interrupted session continues on the next message. A failed or stopped request stays visible to every model, marked incomplete. Long pastes no longer become automatic memories, and isolated worktree tasks share their project's memory. Release details.

Companion miniatures (0.75.6–0.75.7): the cube's small side windows show a scaled-down preview of the whole page; expand one to work in it, also with ⌘1 / ⌘2. Release details.

Chat polish (0.75.4–0.75.5): blue links with the pointing hand, smaller reply buttons, Copy on your own messages, and the five-hour limit's countdown in the menu row. Release details.

Passkey hint (0.75.3): when a site in the built-in browser asks for a passkey, which macOS allows only in full browsers, PM explains it and opens the sign-in in your default browser. Release details.

Settings in one style (0.75.2): every Settings tab follows the Connections layout: rows with their controls on the right, state badges, ⋯ menus for secondary actions and short explanations under each group. Release details.

Connections settings (0.75.1): Settings → Connections lists every connection by purpose with what is connected and its state; each opens its own page with a way back, grouped settings and a ⋯ menu for secondary actions. Release details.

Attachment library (0.74.25): PM keeps copies of the pictures and files sent to chats under Library → Images and Files until you delete them, so a message still shows its picture after the original is gone. Release details.

Zoomable pictures (0.74.24): a picture opened from the chat magnifies like in Preview: pinch, a double click, ⌘+/⌘−/⌘0 or ⌘ with the scroll wheel, up to 800% and sharp from the original. Release details.

Compact controls (0.74.23): smaller buttons around the desktop cube, a slimmer menu row and tighter menus. Release details.

Title glide fix (0.74.22): a long chat title glides while its row is hovered and snaps back when the pointer leaves, without shifting the row. Release details.

Compact sidebar (0.74.21): denser rows, gliding long titles on hover and a card beside the hovered chat with its whole title, model, last activity and state. Release details.

Line totals (0.74.20): the changed-files card under a Claude answer shows the total added and removed lines for the whole turn, with exact counts from Claude Code's patches. Release details.

Pictures in the composer (0.74.19): an image attached to a draft appears as a picture with a remove button, and a note appears only when the image would not reach the model. Release details.

This is the beginning of the README. Read the rest at the original. Read the full README ↗