Frequently asked questions about Atd
Short answers about Atd: what it costs, which Macs and models it works with, where your data stays, and how to use its main features.
General
What is Atd?
Atd is a free, open-source AI agent for macOS that lives in a small desktop panel. Press ⌘ ⇧ Space, select text in an app, or capture your screen to start a task, and Atd works on it with the models you connect, showing its tool activity, file changes and terminal output as it goes.
Beyond conversation, Atd can work in websites and Mac apps with your permission, run automations on a schedule or when files arrive, use MCP servers, skills and subagents, and build small personal apps you can open again.
What does Atd stand for?
Atd stands for “anything, anytime, anywhere, to do.” It is the free, open-source AI desktop agent app for macOS published at atd.best and github.com/JUNERDD/Atd.
Is Atd free and open source?
Yes. Atd is free to download and use, and its source code is published on GitHub (github.com/JUNERDD/Atd) under the MIT License. Atd itself charges nothing.
The only costs come from the AI models you use. Cloud providers may charge under your own account or plan, such as pay-as-you-go API billing or a subscription allowance, while a local model runs on your own hardware.
Learn more: ModelsDo I need an account to use Atd?
No. Atd has no account of its own: download it, open it and connect a model. In Settings → Models, add a provider connection with an account sign-in (such as a ChatGPT plan), an API key, or a local endpoint that needs no key.
Each connection uses the credentials of the provider it connects to, and Atd stores them in your Mac’s keychain.
Learn more: ModelsIs Atd available in Chinese?
Yes. Atd’s interface is available in English and Simplified Chinese. It follows your Mac’s language until you choose one with the Language selector at the top of the Settings window, and the change applies right away without restarting.
Download, install and updates
Does Atd work on Intel Macs?
Yes. Atd runs on both Apple silicon and Intel Macs with macOS 15 or later, and each has its own installer: Atd-arm64.dmg for Apple silicon and Atd-x64.dmg for Intel. Earlier macOS versions aren’t supported.
To check which one you need, open About This Mac: it lists a Chip on Apple silicon and a Processor on Intel. If you install the Intel build on an Apple silicon Mac, its next update moves it to the Apple silicon build.
How do I install Atd?
Download the installer for your Mac from atd.best: https://downloads.atd.best/latest/Atd-arm64.dmg for Apple silicon or https://downloads.atd.best/latest/Atd-x64.dmg for Intel. Open the DMG and drag Atd to Applications.
Open Atd, add a model connection in Settings → Models and choose your default model, then press ⌘ ⇧ Space to open the panel. Atd includes everything it needs to run, so you don’t need to install Node.js; only external tools that a task uses must be on your Mac.
What do I do if macOS blocks Atd from opening?
If macOS blocks the first launch, open System Settings › Privacy & Security and choose Open Anyway, then confirm Open in the prompt that follows.
Do this only for an installer you downloaded from the official links on atd.best or the project’s GitHub releases page.
How do I update Atd?
Atd updates itself. It checks for new versions automatically, downloads them in the background and installs them when you quit Atd, so you don’t need to download the installer again.
While an update downloads, its progress shows in the panel header; once it’s ready, choose Update there to restart into the new version right away. To check yourself, choose Check for Updates… from the menu bar icon’s menu, or Check for updates in Settings → About.
After you update to a new stable version, a Release notes button in the panel header opens that release’s notes.
Models and cost
Which AI models can I use with Atd?
Atd works with the models you connect in Settings → Models. Its catalog covers cloud providers such as OpenAI, Anthropic, Google, DeepSeek, Mistral and OpenRouter, cloud services such as Amazon Bedrock, Azure and Google Vertex AI, and local or custom endpoints.
Connect with an account sign-in where a provider supports it, an API key, or a local endpoint. Each connection keeps its own credentials and default model; new tasks use the default provider and model you choose, and existing tasks keep the model they started with.
Learn more: ModelsCan I use local models with Atd?
Yes. In Settings → Models, under Local and custom, connect llama.cpp, Ollama, LM Studio or vLLM, or add any OpenAI-compatible server as a Custom provider. Local connections work without an API key, and Atd reads the list of available models from the server.
With a local model, model requests go to that server instead of a cloud provider. Tools you allow in a task, such as web search or MCP servers, can still reach the services they use.
Learn more: ModelsCan I use my ChatGPT subscription with Atd?
Yes, if your account is eligible. In Settings → Models, add OpenAI, choose ChatGPT plan, agree to what the connection shares, and sign in to ChatGPT. Requests then use your plan’s allowance instead of pay-as-you-go API billing, and there is no Atd fee for the connection.
Background use is off by default. To let automations, memory maintenance and apps use the plan while you’re away, turn on Allow background use in that connection’s settings. You can also connect OpenAI with an API key instead.
Learn more: ModelsPrivacy and data
Where does Atd store my data?
On your Mac. The installed app keeps task history, settings and memories in ~/Library/Application Support/AgentService, and personal skills and agents in ~/.atd. Provider and MCP credentials are stored in the macOS keychain, and browser environments for computer use keep their sign-in data in separate profiles on your Mac.
There is no Atd account. Model requests go directly from your Mac to the providers you configure, carrying the prompt, conversation context and any attachments or tool results the task includes.
Learn more: Privacy and controlWhat macOS permissions does Atd need?
Only the ones for features you use, and Atd asks for each when you first use the feature that needs it. The selection toolbar needs Accessibility (called Device Control and Data Access on newer macOS versions), and screenshots and screen recordings need Screen Recording.
Computer use in Mac apps needs the same app-control access plus Screen Recording; Settings → Computer use shows their status and opens System Settings for you. You can turn any of them off again in System Settings › Privacy & Security.
Learn more: Privacy and controlDoes Atd ask before it runs commands or changes files?
That depends on the task’s approval mode. Manual approval asks before every file or terminal action; Auto approval has a model check each action against your request, running safe ones and still asking about risky ones; Always allow never asks. New installations start on Auto approval.
Change a task’s mode from the composer, and the default for new tasks in Settings → Permissions, which also holds the shell allowlist. Switching to Always allow asks you to confirm first.
Learn more: Privacy and controlCan I see and delete what Atd remembers?
Yes. Settings → Memory lists every saved memory, filtered by user profile, preferences and facts, corrections and learnings, or tool preferences, and you can edit or delete each one. Memories are stored on your Mac.
Turn off Learn automatically to stop saving new memories while still using the saved ones, or turn on Ask before saving to review each learned memory before it’s kept. Learning uses your configured model and may make extra model calls.
Learn more: Privacy and controlUsing Atd
How do I open Atd, and can I change its shortcuts?
Press ⌘ ⇧ Space to show or hide the main panel, or open it from the menu bar icon. Other default shortcuts: ⌘ ⇧ 2 takes a screenshot, ⌘ N starts a new conversation and ⌘ , opens Settings.
You can change these shortcuts in Settings → General.
How do I use Atd on selected text?
Select text in an app and the selection toolbar appears, where you can ask about the text or run a saved command on it. The answer can replace the selection, go in after it or at the cursor, be copied, or open in a conversation.
Commands can also have their own shortcuts: tap one to reuse the options you picked last, or hold it to choose them. The toolbar needs Accessibility permission, and Settings → General lets you choose how it comes up, exclude apps, or start with a small icon.
Learn more: Selection toolbarCan Atd take screenshots and record my screen?
Yes. Press ⌘ ⇧ 2 to capture an area, mark it up with arrows, step numbers, notes or a mosaic, then ask about it or run commands on its text. For a page longer than the screen, Long screenshot stitches the scrolling area as you scroll or as Auto-scroll moves through it.
Switch to Record on the capture bar to record an element, a window or part of your display, with optional microphone and system audio. Atd reads the detected clicks, keystrokes, screen changes and on-device narration rather than sending the video file to the model. Both need the Screen Recording permission.
Learn more: Screen captureCan Atd control apps and websites on my Mac?
Yes, with your permission. Ask in a conversation and Atd requests access to the websites and Mac apps the task needs. Mac app control is included; for websites, install the optional browser engine from Engines in Settings → Computer use, then add a browser environment, a separate Chrome profile you sign in to.
Atd works in the background where the app or site supports it. Stop all in Settings → Computer use stops computer actions across tasks and automations, and disconnecting an app or website revokes its saved access.
Learn more: Computer useDoes Atd support MCP servers and skills?
Yes. Atd can use MCP servers over stdio, Streamable HTTP or SSE, along with skills and subagents. Add them in Settings → Extensions, one by one or through supported plugin bundles, or ask Atd in a conversation to set one up; it shows what it will save and asks you to confirm.
A newly added MCP server may need your approval in Settings → Extensions before it runs. Type / in the composer to pick an enabled skill, and save prompts you reuse as commands with parameters and their own shortcuts.
Learn more: MCP and skillsDo Atd automations run when Atd is closed?
No. Automations run only while Atd is running. If a scheduled run is missed because your Mac was asleep or Atd was closed, each automation either runs the latest missed occurrence once when Atd is back, or skips it.
An automation can start on a schedule, when files are added or changed in a folder, when your Mac has been idle, or after another automation finishes, and it runs a prompt or a saved command. Runs are unattended, so actions that would need approval are declined instead of waiting. Check status and run history, or pause automations, in Settings → Automations.
Learn more: AutomationsCan Atd build apps for me?
Yes, small personal ones. Describe a tool in a conversation and Atd builds it as an app you can open again from My apps. An app can have its own window, a backend that keeps data and calls the models you’ve connected, and desktop widgets.
To change an app, return to the task where it was made and ask for the change.
Learn more: Personal apps