> ## 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.

# Your first agent

> Meet the Personal Agent the onboarding creates, finish its onboarding, and start talking to it.

The onboarding ends by creating a **Personal Agent** from Agenium's Personal Agent template. It is an ordinary agent: a record in your database with a name, an icon and a description, and a folder on your Mac where its sessions run.

## Open it

Open **Agents** in the sidebar and press the agent's card. Its page shows its identity, the capabilities it can use, its routines and automations, its secrets, and a summary of its tasks. See [Agents](https://docs.agenium.io/app/agents.md) for the whole page.

While the agent's onboarding is unfinished, its card carries an **Onboarding** tag.

## Start a session

**1. Choose the harness**

**New** on the agent's page is a split button. Its main part carries the mark of the harness the session will run in, Claude or Codex; the narrow segment at its right chooses between them. The choice is remembered across agents and launches. With only one harness installed, New has no segment.

**2. Press New**

Agenium opens a new session in the agent's folder, in [Sessions](https://docs.agenium.io/app/sessions.md), with a composer at the bottom.

**3. Write to it**

Type a message and press Send. You can also dictate with the microphone or the dictation key, or start a [voice call](https://docs.agenium.io/recipes/talk-to-an-agent-by-voice.md).

New also appears on an agent's card in the list while the pointer is over it.

## The Personal Agent's onboarding

Until a new agent's onboarding is complete, every interaction with it carries a prompt that tells it what it still has to do. The Personal Agent's onboarding:

1. Asks you to grant it your mailboxes, WhatsApp and Telegram, read-only.
2. Reads their last six months.
3. Writes a dossier on you, a People list with who is who, and the projects and priorities it found.

Granting a connection happens on the agent's page: open the capability's tile, such as Telegram, and use **Give access** to grant one of the Mac's connections, or add the agent's own. See [Capabilities](https://docs.agenium.io/app/capabilities.md#connections) and [Connect a Telegram account](https://docs.agenium.io/recipes/connect-telegram-account.md).

## Add more agents

On the **Agents** page, the **Add agent** card opens a screen of tiles: **Empty agent** first, then each template with its icon, a line of description, and the capabilities it brings. A quiet link there adds an existing agent folder instead.

After you pick one, Agenium asks for the agent's name and where it lives. A template offers a name you can redraw; the folder follows the name until you edit it, and the full path the agent will have is shown under the parent folder you chose last time. Creating shows its steps; a capability that could not be enabled is a note on the created agent, not a failure.


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