Skip to content

Releases

Atlas 0.1.3

Choose a tag to compare

@tornikegomareli tornikegomareli released this 12 Nov 21:58

Install

curl -fsSL https://atlas.insanearts.io/install.sh | sh

Or with Homebrew:

brew trust insanearts/tap && brew install --cask insanearts/tap/atlas

Requires macOS 14 or later. An installed Atlas updates with atlas update.

Changes

Keep your files and accounts safe from agents, see the helper sharply in your agent's app, and keep your Mac fast for days. The helper can no longer open your home folder, your sign-ins are never copied into it, and agents ask you before they send from an account you listed. Atlas also stops the macOS service that slowly made the whole Mac lag while the helper ran, and tells you when macOS names the helper at your screen or stops counting your typing. The live view in agent apps is sharp and far cheaper, Settings is rebuilt as a sidebar of pages, and setup no longer checks the Mac every second and a half. Update with atlas update.

Thanks to Sooheon Kim (@sooheon) for the T3 Code report and its exact diagnosis in #87 and the 1Password report in #94, Adrià Torralba-Agell (@0xAdriaTorralba) for the Universal Control report in #56, Gaurav Gosain (@Gaurav-Gosain) for the job-history report in #80, @michaelaperez-byte for the helper service report in #92, and Alessandro Benassi (@solid-pixel) for asking for a new menu bar icon in #49.

  • Your home folder stays private from the helper: the helper can no longer list or open your home folder. Setup turns this on, Settings > Privacy > Your Files shows it with Make Private and Undo…, and atlas doctor says how many of your folders the helper could open while it isn't private. Your apps and other accounts keep their access, and agents still open your apps and files: Atlas copies each one in first. An agent can make the folder private, never undo it. (#78, #63)
  • Sign-ins are never copied into the helper: Atlas refuses to copy in, or open there, browser profiles and cookies, keychains, the sign-in storage of apps such as Slack and Discord, SSH, GPG and cloud keys, .env and .npmrc, and says what the file is. Copy sign-ins into the helper in Settings > Privacy > Sign-Ins allows it; only you can turn it on. (#78, #62)
  • Accounts, each with a level: Settings > Accounts lists the sites and apps the helper is signed in to, each Look Only, Ask Before Sending or Trusted. Sign In to a Site… opens the site in the helper's browser and gives you control, with agents paused and the screen hidden from them until you choose Done (the site joins at Ask Before Sending) or Cancel. Forget…, Reset… and Sign Out… work the same way. Activity shows which listed account an agent acted in and whether you allowed it. (#78, #62)
  • Atlas asks you before an agent sends: agents can draft freely, but before one sends from an account set to ask, the menu bar icon says Waiting for you, the question shows in the menu bar panel and over the main window's Screen with a picture marking where it acts, and a notification tells you unless Atlas is in front. Choose Just This Once, Allow for This Task or Deny; a question left unanswered ends after two minutes and nothing is sent. (#78)
  • The helper no longer slows your Mac over days: a macOS service in the helper (audioaccessoryd) restarts every 10 seconds while the helper is hidden, and some restarts leave a dead connection in the window server until the whole Mac lags. The helper now pauses that service the moment it restarts, and lets it go when the helper comes on screen or Atlas stops, so nothing piles up. atlas doctor also warns when macOS names another account as the one at your screen, as after logging in to the helper through Screen Sharing; log the helper in at the screen instead. (#93, #92)
  • A note when macOS names another account at your screen: after the helper logs in through Screen Sharing, macOS names it as the account at your screen, and a macOS service in your own login keeps restarting and slows your Mac. The menu bar panel now says so, with Lock Screen: choose Switch User and log back in as yourself to put it right. (#97, #92)
  • Atlas restarts your idle time when macOS stops counting it: with the helper logged in, macOS could stop counting your typing in the idle time your apps read, so apps like 1Password locked on their own. While Atlas is open it now notices and restarts the count. When an app keeps secure keyboard entry on, which holds the count stopped, the menu bar panel and atlas doctor name the app to quit. (#95, #94)
  • The helper stays out of your nearby devices: the helper's rapportd took part in your own login's nearby-device requests, such as AirDrop, which can keep Universal Control from linking. The helper now keeps it paused while it's hidden, and lets it go when the helper comes on screen or Atlas stops. (#96, #56)
  • A sharp live view in agent apps: the view show_screen opens in Claude, Codex and other agent apps now comes at the size it is drawn, up to 1600 px, and sends only the parts of the screen that changed: a still screen costs about 3k characters a poll instead of about 120k. It follows Atlas's own viewer, with the screen first, sessions in a sidebar and Activity with its pictures. The Apps and Screenshots tabs are gone, and for agents the helper_apps, screenshots and screenshot tools are replaced by picture. When an app refuses the view's calls, the view now says so. (#90)
  • The live view loads in T3 Code: the view stayed on "Waiting for the helper's screen…" with "Atlas isn't answering", because its first request carried an empty value that T3 Code refuses. It now leaves the value out, and the screen shows right away. (#88, #87)
  • Settings as a sidebar of pages: Helper, General, Activity, Accounts, Privacy, Integrations and About. Each account has its own page with its app's or site's icon and Back (⌘[), and the window resizes and keeps its size. Click the helper's line at the foot of the main window's sidebar to open Settings on Helper. (#78)
  • A bigger menu bar icon, and a second to choose: the orbit is bigger, and Settings > General offers it or a screen. The panel now opens as a plain card under the icon and names the session that has the helper. (#89, #49)
  • Ended sessions take one line: in the main window's sidebar, an ended session shows its agent's icon, its name and when it started ("12:46", "Wed" or "Nov 8"), or "Cleaning up…" while its work is cleaned up.
  • Setup checks only when something changed: the setup window ran a status command every 1.5 seconds. It now reads when macOS says something may have changed, such as you coming back to the screen, the helper logging in or a permission being allowed, and otherwise every 10 seconds. (#72, #65)
  • Jobs keep starting after many runs: after about 128 jobs, atlas job start and atlas restart refused even with nothing running, and old jobs were never cleared. Atlas now reads the whole job history when needed, clears finished jobs beyond the limit and starts jobs again. (#84, #80)
  • Right-clicking a Dock item works: a right or Control click on a Dock item in the helper was refused. It now opens the item's menu, from the viewer and from atlas click --right. (#91)
  • One menu bar at a time: a second atlas menubar is refused while one runs for the same folder, and an update now stops and restarts the menu bar itself, keeping the previous app if the old one can't be stopped. (#85)
  • Notifications reach you: Atlas is now signed so macOS lets it notify you, and it asks again while you haven't decided. (#78)
  • Control from a chat's view ends when its picture stops: control taken from Atlas's view in an agent app ends after 6.5 seconds without a fresh picture, so you never click on a screen you can't see, and a scroll lands on the picture you scrolled on. (#83)
  • Smaller fixes: Stop, timeouts and cancels end only the command's own processes, even when a process number is reused. File > Save Screenshot says when it fails. Pi's setup writes to Atlas's own config folder. atlas mcp exits on Ctr...
Read more

Atlas 0.1.2

Choose a tag to compare

@tornikegomareli tornikegomareli released this 09 Nov 16:41

Install

curl -fsSL https://atlas.insanearts.io/install.sh | sh

Or with Homebrew:

brew trust insanearts/tap && brew install --cask insanearts/tap/atlas

Requires macOS 14 or later. An installed Atlas updates with atlas update.

Changes

See what an agent saw before each action, a simpler and smoother viewer, a quieter and more reliable live view, and a Mac that stays fast with Atlas running for days. Activity now reads like a story: each session, the apps it used and every step, with a picture of the screen just before it. The helper's screen recorder no longer grows while you watch, the helper's apps no longer play on your speakers, and Atlas tells you when a macOS bug in the helper starts slowing your Mac. Update with atlas update.

Thanks to abenz95 on X for asking for a picture before each action, which became #69.

  • A picture before each action: Activity shows each agent step as a plain sentence with a marked picture of the helper's screen just before it, a before/after compare and a replay of the task. Typed text is kept in full (with an optional limit in Settings), never for password fields. Pictures stay on your Mac for 7 days by default (3, 7 or a custom number of days); Settings > General can also turn them off or delete them all. Agents never receive them, and window titles are never stored with them. (#60, #69)
  • Activity reads like a story: Activity is an outline of sessions, the apps each one used and their steps, with every picture in place and one picture viewer (Copy, Show in Finder, Before and After). The separate Screenshots section is gone: each picture lives with the step that took it. Rows open and fold in one smooth move, and while you're scrolled down, new sessions wait behind a "1 new session" line instead of moving what you're reading. Each session is titled by its project folder, or by its agent when it has none. (#60)
  • A simpler sidebar: the Library and the Apps view are gone. Click a session, or All, to open its Activity; click the small screen in the corner to go back to the live screen. The helper's health sits at the foot of the sidebar as "Atlas is ready", with its details and actions in one menu. (#77)
  • Smoother switching: choosing another session or Activity tab swaps the list in one quick fade instead of every row sliding in from the top. The footer's buttons no longer cross during Take Control, and Activity keeps your place when you go to the screen and back. (#77)
  • A lighter live view: a new picture from the helper now redraws only the picture. Before, every picture rebuilt the whole window, sidebar and Activity included, up to 30 times a second. (#75)
  • Older sessions keep their steps: Activity keeps a month of history (up to 64 MB) instead of about 2 MB, and a session you choose loads its own steps, however far back they are. A session whose steps were cleared says so instead of "Nothing has happened yet". (#76)
  • The helper's screen recorder no longer grows: macOS's screen recorder in the helper kept a little of every picture Atlas took and never gave it back, about 150 MB an hour with the live view open. Every picture, the live view, screenshots and the pictures before actions, now comes from one continuous screen stream, used only once it proves its picture is current, so the recorder stays flat. A recorder that already grew under an earlier version is restarted once after the update, and if it ever passes 1 GB, Atlas restarts it in a pause between clicks and keys, with nothing lost. The live view also asks less of the Mac: at most 30 pictures a second, and only changed pictures are redrawn. (#59, #68)
  • A warning when macOS slows your Mac from the helper: a macOS service in the helper restarts every 10 seconds, and a macOS bug leaves a little behind in the window server each time, so over days the whole Mac slows down. macOS doesn't let Atlas turn the service off. atlas doctor now warns while it's happening and the menu bar shows a one-time note: log the helper out and back in every few days to clear it. No restart of your Mac is needed. (#59)
  • Mute the helper: apps in the helper no longer play on your speakers. On by default, and your own sound is never touched: a speaker button in the menu bar panel and the viewer, "Mute the helper" in Settings > General, and atlas sound on/off. (#58)
  • The live view keeps going through a late frame: one late frame made the viewer end its stream, wait 2 seconds and start again. It now keeps the stream and restarts only when pictures really stop. After an update, the viewer window opens again if it was open. (#70, #67)
  • Fewer needless refusals when an app is busy: when an app couldn't answer Atlas's focus check in time, such as TextEdit with a very long document, Atlas refused the command. It now asks again while the command still has time. (#71, #66)
  • No more rare "permission denied" from the helper: once in a long while macOS briefly refused Atlas's connection to the helper, which could fail a command or leave it uncertain. Atlas now tries the connection again for a moment; nothing is ever sent twice. (#73)
  • Editing your settings no longer blocks updates: atlas update refused if ~/.config/atlas.toml changed after setup. It now refuses only when the helper's identity or the output folder changed, and Atlas's own settings changes keep the rest of your file exactly as you wrote it. (#60)
  • The installer leaves other apps named Atlas alone: install.sh replaces only Atlas itself and stops with a clear message if another app named Atlas is in /Applications. (#57)
  • Pi can take screenshots through MCP: Pi now exposes Atlas's take_screenshot tool, returning the helper's picture inside the tool reply. Pi previously hid the tool. (#82)
  • No partial app copies in the helper: on macOS 27, ditto can skip a folder it cannot read and still report success. Atlas now refuses that copy instead of installing an incomplete app.
  • Install with Homebrew: brew trust insanearts/tap && brew install --cask insanearts/tap/atlas. Each release now updates the cask. (#79)

Resolves #66, #67, #68 and #69.

Atlas 0.1.1

Choose a tag to compare

@tornikegomareli tornikegomareli released this 05 Nov 22:03

Install

curl -fsSL https://atlas.insanearts.io/install.sh | sh

Requires macOS 14 or later. An installed Atlas updates with atlas update.

Changes

The first update after launch. Setup no longer does its heaviest work while you unlock your account after switching back from the helper, Compose Desktop apps now take clicks and typing in the helper, commands no longer finish late because of a rare process race, reopening Atlas from its icon shows the viewer when none of its windows are open, and agents get one-window screenshots and one-call value readouts so they finish tasks in fewer, cheaper turns. The docs now say plainly what the helper shares with your account. Update with atlas update.

Thanks to @INGHRTY, first-time contributor, for making Atlas's app icon open the viewer in #52, and to Wojciech Gryglas (@wgryglas) for the detailed report and Swing probe in #51.

Thanks also to everyone who reported problems and asked questions on X and Reddit after launch.

  • Setup waits until you're back in your own account: a Mac froze for one person while they unlocked their account after switching back from the helper during setup. Atlas started its end-to-end check, which starts input in the helper and takes a test screenshot, the moment the helper left the screen, while they were still at the login window. Setup now reads nothing while the login window has the screen and starts the check only once you have been back in your own account, unlocked, for a moment; atlas init waits the same way. Two system tools setup checks every second and a half, codesign and launchctl, now have time limits. (#54)
  • A clear answer for apps that run in one account at a time: atlas open of an app such as Tailscale while it's open in your account told the agent to check that the app exists. Atlas now says the app runs in one account at a time and is open in another, and tells the agent not to retry it or quit yours. (#54)
  • Compose Desktop apps accept clicks and typing: a Compose Multiplatform desktop window reports a focused element that no longer exists, so Atlas could not tell where keyboard focus was and refused every click and keystroke with focus-changed, sending nothing. Atlas now asks once more, and when the element is still gone it judges the focused window instead, as it already does for apps with no focused element. Any other failure to read focus still refuses, so input never lands in a window Atlas cannot account for. (#53, part of #51)
  • Known limit: Java and Compose windows can show an old picture: in the helper, Java (Swing) and Compose windows take input and their state is right, but the picture on screen stays old until the window is resized, and a resize can show an earlier layout. macOS doesn't show new frames drawn with Metal or OpenGL in a login that isn't on screen. In our tests the pictures update while a signed-in Screen Sharing session to the helper is open. Otherwise, read the app's state with atlas elements --app NAME --values. (#51)
  • Finished commands report on time: on macOS a process that another part of Atlas started at the same moment could inherit both ends of a command's output pipe and hold it open, so a command that had finished was reported late and its cleanup could be recorded as an unknown outcome, which blocks agents until atlas restart. Atlas now starts every process and creates every pipe one at a time, held only for the instant of the start. (#48)
  • Opening Atlas from its icon shows the viewer: opening Atlas from Applications, Launchpad or the Dock while it was already running did nothing, which looked like the app failing to open. It now opens the viewer when none of Atlas's windows are open. Opening a set-up Atlas that is not running also opens the viewer now, instead of only starting the menu bar item. (#52)
  • Screenshot one window: atlas screenshot --app NAME --window N captures just that window, and --region now works together with --app to crop part of an app. Smaller pictures cost an agent fewer tokens per look. (#50)
  • Read a whole form in one call: atlas elements --values lists each element's role, name, value and state (disabled, focused, selected, a menu item's mark) instead of its position. --name can be repeated to read several fields at once, and the reply says which names matched nothing. --page keeps only what a web page shows, without the browser's own toolbar and tabs, and --window N limits the listing to one window. (#50)
  • Screenshots through MCP: a new take_screenshot tool returns the picture inside the tool reply, so hosts that show images see it without opening a file. It runs atlas screenshot with the same checks and record, and never changes where another chat's untargeted clicks go. (#50)
  • Each web page gets its own browser window: atlas open --app "Google Chrome" URL opens the page in a new window when Chrome is already running, so two agents' pages never share one window. The same applies to Chrome Canary, Chromium, Brave and Microsoft Edge. (#50)
  • Agents finish in fewer turns: the bundled Atlas skill now tells agents to chain known steps, prove a step by reading its value back, and take a screenshot only when text cannot show the result. The MCP status reply gives the model only the facts it acts on; the full status goes to Atlas's embedded view. (#50)
  • Docs: what the helper shares: a new section in Using Atlas lists what the helper has of its own (pointer, clipboard, files, keychain) and what it shares with your account (speakers, network, CPU and the process list). It gives the helper's memory use, says that sound from the helper plays on your speakers with no helper-only mute yet, and explains what happens with apps you also use, such as Slack, a password manager or Tailscale. (#55)
  • Docs: your files: the README and Using Atlas now say how an agent copies in only the files an app needs and brings results back with atlas collect, and that the helper can read what every account on your Mac can, including /Users/Shared, most external drives and folders in your home that aren't private, with the one command that makes a folder private. (#55)

Addresses part of #51.

Atlas 0.1.0

Choose a tag to compare

@tornikegomareli tornikegomareli released this 04 Nov 10:25

Install

curl -fsSL https://atlas.insanearts.io/install.sh | sh

Requires macOS 14 or later. An installed Atlas updates with atlas update.