Requirements
Mac
- Apple-silicon Mac running macOS 26 (Tahoe) or newer for NativeAgent 0.6.6;
- a supported AI provider selected by the user; and
- user-granted permissions for any optional Mac integrations.
iPhone and iPad
- iOS or iPadOS 17 or newer;
- the NativeAgent mobile app and a compatible NativeAgent Mac release;
- both devices using the intended Apple account with iCloud enabled; and
- the Mac running when chat, tools, memory, or actions are needed.
Make the agent yours
Enter your name and the agent’s name, connect one AI account, and complete setup. The agent asks what you want it to be for you; answer in your own words or skip straight to a task. A saved role appears as a receipt beside the conversation.
Providers has three groups: Chat, Work, and Memory and mind. Work and Memory and mind follow Chat until you choose otherwise. Each bot keeps the provider and model chosen for that bot.
Set up Chrome
In NativeAgent, open Trust → Set up Chrome. The extension is included with the app; setup exposes its folder in Finder and opens Chrome’s extensions page. Turn on Developer mode, choose Load unpacked, and select the folder. Then check the live status in Trust.
The extension must be installed on each Mac. A NativeAgent tab group appearing through Google sync does not mean the extension is installed or connected on that computer.
Connect another agent
Ask “Connect to Codex” or name another supported local agent. Review the proposed settings change. In Work mode the connection can be prepared; running a local agent to check the link needs Full Mac. Manage peer permissions in Trust → Connected agents; disconnecting restores the backed-up setup.
Pair a phone or tablet
- Launch NativeAgent on the Mac and complete onboarding.
- Open Settings inside NativeAgent on the Mac and find iPhone and iPad pairing.
- Keep both devices signed into the intended Apple account with iCloud enabled.
- Launch NativeAgent on mobile and connect after the signed pairing material arrives.
- If iCloud propagation is delayed, use the manual pairing key shown by the Mac.
Automatic pairing is the first path. Treat the manual pairing key as a secret; do not screenshot or share it.
Common problems
The phone says the Mac is offline
Keep NativeAgent running on the Mac, confirm iCloud is available on both devices, refresh mobile, and re-pair if the Mac pairing key changed. Pending work does not silently switch to another runtime.
A mobile action is waiting
The Mac must receive, verify, authorize, execute, and return a terminal receipt. Keep it running and resolve any approval shown there. Do not repeat a consequential action while its first receipt is pending.
Notifications do not appear
Enable NativeAgent notifications in iOS Settings, confirm pairing and Mac reachability, and review Focus, notification summary, lock-screen preview, and time-sensitive notification settings.
A provider or connector does not work
Reopen Providers or Connectors on the Mac, verify the credential and requested scope, and check the external service's availability and account limits.
A bot did not run
Open its card for the missed or blocked reason. Check its selected account and model, schedule, configured limits, and effective unattended-work policy. A missed occurrence is not silently retried; Run once starts an explicit new request.
A Mac permission is missing
Use Mac Integration in NativeAgent, then review System Settings → Privacy & Security. Apple grants Calendar, Reminders, Contacts, and other protected services separately.
Updates
Official direct-download Mac releases use the app's signed update feed when available. NativeAgent 0.6.6 requires macOS 26; Macs on older systems should remain on the last compatible release. iPhone and iPad updates are delivered by the App Store or TestFlight.
Report a problem
Include the NativeAgent version, operating-system version, device model, affected surface, exact action, visible error, and whether an ordinary relaunch reproduces it. Redact support snapshots before sharing.
Open a support issue for ordinary bugs. Use a private security advisory for vulnerabilities or sensitive privacy matters.
Never post API keys, OAuth tokens, pairing keys, private prompts, personal files, or unredacted support archives.
Data removal and safety
Export work you want to keep before cleanup. Disconnect mobile pairing before deleting the mobile app. Quit the Mac app before removing its Application Support data or workspace. Remove iCloud, backup, provider, and connector records through the services that own them.
NativeAgent is provided under the MIT License without warranty. Keep backups, verify consequential outcomes, grant the least authority practical, and do not rely on it as the sole control for emergency, medical, legal, financial, or safety-critical decisions.