Database
AgentKit keeps your agents, tasks, Inbox and its own marks in a shared database. Two tabs offer two ways to get one:- Supabase (the default): connect through Supabase’s own sign-in, with no credentials to copy. AgentKit creates a project or connects one you have, sets up a database role and schema of its own, and turns on the project’s SSL enforcement - saying first, for an existing project, that clients without encryption will stop connecting. See Connect a Supabase database.
- Postgres: any Postgres of your own, local or remote, by its credentials. You run it and answer for it.
- Pool size, while the database is a Supabase session pooler: the limit the sidebar’s Database row measures against, 15 by default.
- Connections: how many connections AgentKit keeps open for its own reading, 2 by default.
Coolify
Coolify is the platform where AgentKit places resources, such as an agent’s server node. AgentKit holds one Coolify connection of its own; it belongs to the app, not to any agent.- Connect an existing instance by its address and API token. AgentKit validates the token and keeps it in a file of its own, readable only by you.
- Create instance takes the IP address of a server your Mac reaches as root over SSH, and starts an Oracle session that installs Coolify there and pairs it with your Mac. See Connect Coolify and create an instance.
Sidebar
A switch per sidebar widget: Claude usage, Codex usage, CPU, Thermal, Memory, Top processes and Database. All are on by default except Thermal and Top processes.Sessions
How the Sessions list shows and orders work:- The working indicator and the watching indicator, each choice shown animated.
- The list’s order: latest turn, most recent activity, or started.
- The agent icon size on rows: small or large.
- How a session becomes read: Manual or On open.
- The session text size, a step larger or smaller than the rest of the interface.
- Continuing after a restart: the phrase AgentKit sends to the sessions it continues, and a switch that turns continuing off.
- The context share at which an eternal session compacts, 40% by default.
Tasks
The agent icon size on Tasks rows and cards, chosen apart from Sessions.Claude and Codex
Each harness has a section of defaults for the sessions AgentKit starts. Each opens with its account line - who is signed in and how, a subscription or an API key - with Sign out and Switch account, or Sign in while none is signed in. Signing in goes through the harness’s own browser login; AgentKit never reads or writes the harness’s credentials.- Claude: the mode a new session starts in, Bypass permissions unless you choose otherwise.
- Codex: the approval choice a new session starts with, Full access unless you choose otherwise.
Notifications
For each event, two switches: Notifications for macOS and Telegram. Mac is on and Telegram off by default.
An event that needs you plays a sound and stays in Notification Center until it is resolved, when AgentKit withdraws it. Clicking a notification brings AgentKit forward on its subject. Notifications are local: AgentKit raises them only while it runs.
Above the switches, the section shows whether macOS allows AgentKit’s notifications, with Turn on or Open System Settings as needed.
Telegram
AgentKit can also send its notifications to Telegram through a bot you create. Paste the bot’s token, then bind one chat by sending the bot a one-time code through the start link. AgentKit writes only to that chat. The section shows the bound chat, sends a test message, shows the last failed send, and disconnects. A message reads like the macOS notification, names the agent, and is edited rather than deleted once the event is resolved.Transcription
Voice input in the composer:- Provider: Deepgram.
- API key: validated against Deepgram and kept in a file of AgentKit’s own, readable only by you. It is the Mac’s one Deepgram key, which every capability that transcribes uses too.
- Model: the newest general model by default.
- Language: Automatic by default, which follows a switch of language within one phrase, or one language.
- Dictation key: one tap of right Option by default, or right Command, Fn, or none.
- Key terms: words to recognise; type one and press Enter, or paste a list.
- Sounds: Soft (the default), Tink, Glass, Click, or Off.