Using Agentum

Agentum’s window is a command center for the agents running on your Mac. This page walks through each surface and the things you’ll do most often. If you haven’t installed yet, start with Getting Started.

The shell at a glance

  • Sidebar (left) — navigation: chat, your agents, the Marketplace, system settings. Collapsible to a slim icon rail.
  • Main panel (center) — whatever you selected: Agentum Chat by default, or an agent’s page, the Marketplace, the Create flow, the System view.
  • Sidekick rail (right, optional) — a companion panel that appears on agent pages when you toggle it; see Improving Agents.

Agentum Chat — the home screen

The app opens into Agentum Chat: one conversation surface for everything your agents want to tell you and everything you want to ask them.

  • The pinned ✨ Agentum thread is the delivery channel. Agents post here proactively — updates, reminders, questions — each message labeled with the agent it came from. When an agent asks something with fixed options, the options arrive as real buttons you tap; otherwise just type a reply. This is also what drives the unread badge on the sidebar and macOS notifications.
  • If you’ve connected Telegram, a pinned 📱 Telegram thread mirrors your phone conversation — read and reply from the desktop; New conversation resets the thread on both ends.
  • The composer supports slash commands with autocomplete: type / to see built-ins (/help, /model, …) plus every command your installed agents registered.
  • If your AI isn’t configured yet, the chat shows a Set up your AI banner instead of failing — one click to the LLM settings.

The same conversation is available in your browser and on your phone via Agentum Web Chat.

The sidebar

Top to bottom:

  • Search filters your agent list as you type.
  • Nav rows — Agentum Chat (with unread count), Create Agent, Marketplace. (A Dashboard row appears if you enable the dashboard in Settings → Interface.)
  • Favorites — star any agent to pin it here; drag to reorder.
  • Your sections — group agents however you like: create sections, rename them, drag agents between them, collapse the ones you don’t need today. Applications with sub-agents nest as expandable trees.
  • Integrations and Paused Agents — auto-managed collapsible groups for connector-type agents and anything you’ve disabled.
  • Footer — the System gear (settings), a ? for sending feedback, a health badge that appears when agents are erroring (click it to jump to the problem), and your Account button (license status, trial countdown, cancel/reactivate).

An agent’s page

Click any agent to open its page. The header shows its name, a provenance pill — Editable (yours) or Marketplace (managed) — and status banners when something needs attention (disabled, failing, recent errors with an expandable detail ring).

The toolbar tabs:

Tab What it is
Main The agent’s own dashboard — its live panel, stats, and its own settings controls.
Guide The agent’s documentation: a rendered guide (some agents ship full multi-page HTML docs) plus a setup checklist. A dot on the tab means unfinished setup steps.
Improve The AI editing surface — your agents only; see Improving Agents.
Sidekick Toggles the companion rail — ask questions about this agent in plain English.

Everything else lives in the ⋯ menu: the Enable/Disable switch, Integrations (which services this agent may touch — see below), Advanced (add-on capabilities and cross-agent data access), Share Agent (export, your agents only), and Uninstall.

How integration grants work

When an agent is installed, Agentum auto-grants the integrations its manifest declares (Telegram, AI, Calendar, …). Open ⋯ → Integrations to see them as toggles. Revoking one doesn’t break the agent — a well-built agent keeps running with reduced capability, and any blocked call gets a clear denial. Flip it back on and access resumes immediately, no restart. The same panel governs which other agents’ data this agent may read.

Enabling and disabling whole agents is just as light-weight — the change applies live to the running system, no restart needed.

The Marketplace

Click Marketplace in the sidebar. Four tabs:

  • All — the full catalog: curated groups (stacks of agents that work together — install a group and its members are set up and granted in one shot) plus a searchable grid.
  • Featured — the editorial picks.
  • Installed — what you have, split into Active and Disabled, each card with an Update pill when a new version is out.
  • Updates — everything with a pending update, plus Update all. Routine updates apply in one click; any update that requests new permissions is set aside for your explicit review — you’ll see exactly what’s being added before you approve.

Installing opens a drawer with the agent’s description, screenshots, and what it needs; one click and it’s live in your sidebar. Uninstalling preserves the agent’s data for one round of reinstall, so a change of heart costs nothing.

Marketplace agents are managed: Agentum keeps them updated and their code sealed read-only (no Improve tab, no export). Your own creations are fully editable. Both live side by side in the sidebar with their provenance pill.

The System view

The gear in the sidebar footer. Three tabs:

Services

The runtime view. The Agent card shows the background agent process — Running (with PID and uptime), Starting, Restarting, Crashed, or Stopped — with Stop and Restart buttons. This one restart button is the fix for most “my agent is acting weird” moments: a few seconds, no app relaunch.

Below it: the Agents folder card (where your agents live on disk — ~/Documents/Agentum/agents by default — with change and reveal-in-Finder controls) and the Software update card (current version, check/download/install).

macOS note: if your agents folder sits in a location macOS protects, the agent card walks you through granting access in Privacy Settings — a restart alone can’t fix a permissions block.

Settings

Card per concern, top to bottom:

  • Profile — your name, the assistant’s persona, your Google account connection (Gmail, Calendar, Drive, Docs, Tasks — one Connect button).
  • LLM Provider — your AI and your coding assistant; see Choosing Your LLM & Coding Harness.
  • Interface — appearance options (including showing the optional Dashboard).
  • Bot & messaging and Telegram Mini App — the Telegram stack; see Telegram Setup and Remote Access.
  • Web Chat and Paired devices — browser chat and its device approvals; see Agentum Web Chat.
  • Chrome automation — the optional browser bridge extension.

Cards write through to the running system when you save; anything needing an agent restart raises a banner with the button right there. There is no configuration file to hand-edit — if you find an old guide telling you to edit .env, it’s obsolete.

Advanced

Four inner views:

  • Health — every agent currently erroring or degraded, with the latest error and a jump-to-agent link. The sidebar’s health badge deep-links here.
  • Capabilities — add-on capabilities and which agents they augment.
  • Schedulers — every recurring job your agents have registered: cadence, last fire, and status, grouped by agent and refreshed live. Your first stop when “my agent didn’t run this morning” — a stale last-fire or a red error tells you exactly which job to look at.
  • General — agent-data backup, the authoring kit export, and the Danger Zone (re-run onboarding, reset).

Your account

The Account button in the sidebar footer shows your license at a glance — Trial — N days left or Lifetime — and holds the account actions: cancel trial, reactivate, refresh license. Details in Account & Billing.

Where to next