> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agenium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> AgentKit is a native macOS app that gives one window over the agent work happening on your Mac.

AgentKit, by Agenium, is a native macOS app that shows and steers the agent work on your Mac in one window: the Claude and Codex sessions running now and their activity, the agents you keep, the capabilities those agents work with, and the tasks, questions and conversations they produce.

Every surface that runs an agent - an editor, a desktop app, a terminal - runs a session of one of the agent harnesses, Claude Code or Codex. AgentKit reads those sessions directly on the Mac and shows them together, and it can start and continue sessions of its own.

## What is in the window

> [card] [Sessions](https://docs.agenium.io/app/sessions.md)
>
> A live list of every Claude and Codex session, with its activity, and a composer to talk to the sessions AgentKit runs - by text, dictation or a voice call.

> [card] [Agents](https://docs.agenium.io/app/agents.md)
>
> Your agents: their identity, capabilities, routines, automations, secrets and the nodes they run on.

> [card] [Capabilities](https://docs.agenium.io/app/capabilities.md)
>
> The tools agents work through - mail, Telegram, tasks, memory, deployment and more - with their connections, services and settings.

> [card] [Tasks](https://docs.agenium.io/app/tasks.md)
>
> The work tracked for your agents, as a table or a board, with each task's runs and timeline.

> [card] [Inbox](https://docs.agenium.io/app/inbox.md)
>
> Everything an agent puts before you: decisions, questions, conversations and notices.

> [card] [Rooms](https://docs.agenium.io/app/rooms.md)
>
> The conversations agents and people hold in shared rooms, live.

> [card] [Teams](https://docs.agenium.io/app/teams.md)
>
> Groups of agents that share instructions.

> [card] [Oracle](https://docs.agenium.io/app/oracle.md)
>
> AgentKit's own agent, which helps you set up the app and look after your agents.

## How it fits together

```mermaid theme={null}
flowchart LR
  subgraph mac["Your Mac"]
    ak["AgentKit"]
    cc["Claude Code"]
    cx["Codex"]
    caps["Capabilities<br/>(command-line tools)"]
    folders["Agent folders"]
  end
  db[("Shared database<br/>Supabase or your Postgres")]
  servers["Your servers<br/>(optional nodes)"]

  ak -- "reads sessions" --> cc
  ak -- "reads sessions" --> cx
  ak -- "changes state through" --> caps
  caps --> db
  ak -- "reads" --> db
  cc --> folders
  cx --> folders
  caps -- "run services on" --> servers
```

* An **agent** is a record in a shared database: its name, description, icon, settings and grants. A folder on your Mac, or a server, is one of its **nodes** - a place where it is set up and can run.
* A **capability** is a self-contained command-line tool an agent works through, such as a mailbox, Telegram, tasks or memory. Capabilities are installed on the Mac, allowed or kept in quarantine, and switched on per agent.
* A **connection** is a capability's access to an outside account, such as one mailbox or one Telegram account. An agent reaches a connection only when it is granted to it.
* The **shared database** holds agents, tasks, the Inbox, AgentKit's own marks and the capabilities' records. AgentKit reads it directly and changes it only through the owning tool's command, so what you do in the app is what the tools themselves would do.

## The sidebar

The sidebar holds the sections, and under them a few quiet widgets:

* **Claude** and **Codex** usage: how much of the 5-hour and weekly limit is used and when each resets, turning orange from 80%. While a harness has no signed-in account, its block offers **Sign in**.
* **System**: CPU with a two-minute chart, thermal state, memory and its pressure, the busiest processes, and the shared database's connections. A click on a row changes its view.
* **Ask Oracle**, which starts a session with [Oracle](https://docs.agenium.io/app/oracle.md), and above it **Update** when a new release is ready.
* The footer shows the version, the release stage (alpha) and the build.

Drag the sidebar's edge, press ⌘B, or choose **View > Toggle Sidebar** to fold it into a thin icon rail where each widget becomes a small gauge. Each widget is shown or hidden in [Settings > Sidebar](https://docs.agenium.io/app/settings.md#sidebar).

> [!TIP]
>
> ⌘+ and ⌘− make the whole interface larger or smaller, and ⌘0 returns it to its actual size. AgentKit reads in English, Russian and Estonian; choose in [Settings > Interface language](https://docs.agenium.io/app/settings.md#interface-language).

## Next

> [card] [Install AgentKit](https://docs.agenium.io/install.md)
>
> Download, sign in and go through the onboarding.

> [card] [Your first agent](https://docs.agenium.io/first-agent.md)
>
> Meet the Personal Agent and start talking to it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.